docs: Document the `--existing` CLI option (#61979)
# Objective
Fixes #61730.
Document the `-e`, `--existing` CLI option, which was missing from the
CLI reference.
## Solution
- Added documentation for the `-e`, `--existing` CLI option.
- Added a usage example.
- Updated the default behavior note to include `-e`.
## Testing
- Built the documentation locally using `mdbook`.
- Verified that the new section renders correctly in the CLI Reference
page.
- Confirmed the example and updated default behavior note appear as
expected.
## Self-Review Checklist
- [x] I've reviewed my own diff for quality, security, and reliability
- [x] Unsafe blocks (if any) have justifying comments
- [ ] The content adheres to Zed's UI standards (Not applicable)
- [ ] Tests cover the new/changed behavior (Documentation change only)
- [x] Performance impact has been considered and is acceptable
## Showcase
The CLI Reference now includes documentation for the `-e`, `--existing`
option.
<details>
<summary>Documentation Preview</summary>
<img width="935" height="539" alt="Screenshot 2026-07-31 151714"
src="https://github.com/user-attachments/assets/c2e4ad05-a961-4fe1-8c22-5e3a474e96ca"
/>
</details>
---
Release Notes:
- Improved CLI documentation by adding the missing `--existing` option.
9c7a5c9485Mohammad Adnaan committed on 7/31/2026, 10:02:11 AM· committed by GitHubparent4f047ac