# docs: Document the \`\-\-existing\` CLI option \(\#61979\) · gitcafe/zed

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

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

Visibility: public

Requested revision: 9c7a5c9485669f57a22bc9c07b0f856cf1829a34

Requested commit: 9c7a5c9485669f57a22bc9c07b0f856cf1829a34

Commit: 9c7a5c9485669f57a22bc9c07b0f856cf1829a34

Tree: a909045761abb8204e7e1b4ebda2dfc556185b25

Author: Mohammad Adnaan

Committer: GitHub

## Message

```
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.
```

## Parents

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

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