Skip to content

Document Zed cli_default_open_behavior for one window per worktree#1

Open
blacroix wants to merge 1 commit into
supabitapp:mainfrom
blacroix:zed-window-config-hint
Open

Document Zed cli_default_open_behavior for one window per worktree#1
blacroix wants to merge 1 commit into
supabitapp:mainfrom
blacroix:zed-window-config-hint

Conversation

@blacroix

@blacroix blacroix commented Jun 19, 2026

Copy link
Copy Markdown

What

Adds a short hint to Repository Settings docs explaining how to get one Zed window per worktree.

When a repository's "Open in" target is Zed, Supacode opens each worktree in its own window (and focuses the existing window if already open). This only works when Zed's cli_default_open_behavior is set to new_window — Zed's default is existing_window, which collapses every worktree into a single shared window.

The note tells users to set it via zed://settings/cli_default_open_behavior or their Zed settings.json.

Context

Documents the behavior shipped by supabitapp/supacode#423 ("Generalize worktree open targets", merged), which opens Zed through its bundled CLI with the bare worktree path — relying on this setting. Relates to supabitapp/supacode#399.

When the "Open in" target is Zed, Supacode opens each worktree in its own
window. This requires Zed's `cli_default_open_behavior` to be `new_window`
(default is `existing_window`, which collapses worktrees into one window).
Add a short hint under repository settings explaining the setting and how to
reach it (`zed://settings/cli_default_open_behavior`).
@blacroix blacroix marked this pull request as ready for review June 19, 2026 15:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant