# Clarify how \`agent.flexible\` affects \`agent.default_width\` \(\#63020\) · gitcafe/zed

[View on GitCafe](https://git.cafe/gitcafe/zed/commit/5151c7953d6be4b425a33669535f60dadf6e8edd)

Repository: [gitcafe/zed](https://git.cafe/gitcafe/zed)

Visibility: public

Requested revision: 5151c7953d6be4b425a33669535f60dadf6e8edd

Requested commit: 5151c7953d6be4b425a33669535f60dadf6e8edd

Commit: 5151c7953d6be4b425a33669535f60dadf6e8edd

Tree: 9c33640ec66f0f5bfaf6d05ac08fdc7bb375573f

Author: Dom Porada

Committer: GitHub

## Message

```
Clarify how `agent.flexible` affects `agent.default_width` (#63020)

## Objective

`agent.default_width` is described as the Agent Panel’s default width,
but panels docked to the left or right use proportional sizing while
`agent.flexible` is enabled. Because flexible sizing is enabled by
default, double-clicking the outer resize handle restores the default
proportion rather than the configured pixel width. This can make
`agent.default_width` appear to be ignored.

## Solution

Clarify that `agent.default_width` controls the fixed width used when
`agent.flexible` is disabled, while resetting a flexibly sized Agent
Panel restores its default proportion.

Update the default settings comments, settings documentation, Settings
UI description, and visual customization guide. Add `agent.flexible` to
the Agent Panel configuration example and explain how it affects reset
behavior. No sizing behavior changes.

## Testing

- `cargo fmt --all -- --check`
- No runtime testing—the change only updates settings descriptions and
documentation.

## Self-Review Checklist:

- [x] I’ve reviewed my own diff for quality, security, and reliability
- [x] Unsafe blocks (if any) have justifying comments
- [x] The content adheres to Zed’s UI standards
([UX/UI](https://github.com/zed-industries/zed/blob/main/CONTRIBUTING.md#uiux-checklist)
and
[icon](https://github.com/zed-industries/zed/blob/main/crates/icons/README.md)
guidelines)
- [x] Tests cover the new/changed behavior
- [x] Performance impact has been considered and is acceptable

Release Notes:

- N/A
```

## Parents

- [ee1c6f8c40ce2a1f723cadebf0633481a4f52417](https://git.cafe/gitcafe/zed/commit/ee1c6f8c40ce2a1f723cadebf0633481a4f52417?format=markdown)

[Source at this commit](https://git.cafe/gitcafe/zed/tree/5151c7953d6be4b425a33669535f60dadf6e8edd?format=markdown)