zed/docs/src
Danilo Leal 9daf886775
Move the worktree picker to the title bar + make it always visible (#54183)
This PR makes Zed only have one worktree picker, as opposed to a flavor
of it in the title bar and another in the agent panel. It then moves it
to the title bar, making it always present, so that its trigger is
separate from the branch picker (which now contains only two views:
branches and stashes). For the worktree picker, I'm mostly favoring the
behavior we've introduced in the agent-panel-flavored version.

It also updates the title bar settings migration to use the JSON
`migrate_settings` helper instead of a shallow Tree-sitter rewrite, so
old `show_branch_icon = true` values are promoted to
`show_branch_status_icon = true` across root, platform, release-channel,
and profile settings scopes.

- [x] Move worktree creation logic to the `git_ui` crate to make this
more generic and less agent-specific
- [x] Double-check the remote use case and ensure nothing broke there
- [x] Improve the UX for the detached HEAD state; better invite people
to create a branch
- [x] Migrate `show_branch_icon = true` to `show_branch_status_icon =
true` across nested settings scopes

Suggested .rules additions

When migrating renamed settings keys that can appear in platform
overrides, release-channel overrides, or profiles, prefer the JSON
`migrations::migrate_settings` helper over shallow Tree-sitter key
rewrites unless tests explicitly cover every nested scope that can
contain the key.

Release Notes:

- Improved migration of the title bar branch status icon setting.

---------

Co-authored-by: Nathan Sobo <nathan@zed.dev>
Co-authored-by: Zed Zippy <234243425+zed-zippy[bot]@users.noreply.github.com>
Co-authored-by: Ben Brandt <benjamin.j.brandt@gmail.com>
2026-04-20 09:29:51 +00:00
..
ai Move the worktree picker to the title bar + make it always visible (#54183) 2026-04-20 09:29:51 +00:00
collaboration docs: Remove Preview callouts for stable release (#50736) 2026-03-04 15:10:13 -05:00
development Removal of mold/wild scripts and mentions in docs (#53078) 2026-04-08 21:20:02 +03:00
extensions language_core: Introduce fallback highlights (#52575) 2026-04-02 12:52:42 +00:00
languages docs: Exemplify a Django app debug configuration (#53545) 2026-04-16 07:05:25 +00:00
migrate editor: Add configurable hover delay (#53504) 2026-04-13 09:46:19 +03:00
reference Move the worktree picker to the title bar + make it always visible (#54183) 2026-04-20 09:29:51 +00:00
all-actions.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
appearance.md Add hotkeys and actions for toggle light and dark theme (#49027) 2026-03-12 21:35:42 +02:00
authentication.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
command-palette.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
completions.md Remove Supermaven-related code from Zed (#50537) 2026-03-02 22:18:49 +00:00
configuring-languages.md Gate Format Selections on whether the active formatter can actually format ranges (#53178) 2026-04-16 09:11:22 +03:00
configuring-zed.md Add vim/emacs modeline support (#49267) 2026-03-25 03:15:51 +00:00
debugger.md docs: Remove Preview callouts for stable release (#50736) 2026-03-04 15:10:13 -05:00
dev-containers.md docs: Add AI SEO frontmatter (#48559) 2026-02-11 13:10:31 -08:00
development.md Improve documentation for ETW profiling (#50426) 2026-02-28 23:03:49 -05:00
diagnostics.md docs: Add AI SEO frontmatter (#48559) 2026-02-11 13:10:31 -08:00
editing-code.md docs: SEO content improvements for AI section (#49128) 2026-02-13 13:05:57 -08:00
environment.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
extensions.md Remove text thread and slash command crates (#52757) 2026-03-31 17:55:05 +02:00
finding-navigating.md Remove search_on_input from docs (#52435) 2026-03-25 18:41:37 +00:00
getting-started.md docs: Remove Preview callouts for stable release (#50736) 2026-03-04 15:10:13 -05:00
git.md docs: Update File History menu label from Open to View (#49859) 2026-03-01 10:02:33 +00:00
globs.md docs: Remove Preview callouts for stable release (#50119) 2026-02-25 14:16:54 -06:00
helix.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
icon-themes.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
installation.md docs: Add AI SEO frontmatter (#48559) 2026-02-11 13:10:31 -08:00
key-bindings.md Fix docs validation to detect unknown keys (#49660) 2026-02-19 20:46:21 -05:00
languages.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
linux.md Deprioritize Flathub (#53857) 2026-04-14 20:42:16 -06:00
macos.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
modelines.md Add vim/emacs modeline support (#49267) 2026-03-25 03:15:51 +00:00
multibuffers.md docs: Add AI SEO frontmatter (#48559) 2026-02-11 13:10:31 -08:00
outline-panel.md docs: Remove Preview callouts for stable release (#50736) 2026-03-04 15:10:13 -05:00
performance.md docs: Center and re-flow perf images (#53004) 2026-04-02 10:24:43 -06:00
quick-start.md docs: Reorganize introduction (#41387) 2025-10-28 17:39:40 -03:00
remote-development.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
repl.md docs: Remove Preview callouts for stable release (#50119) 2026-02-25 14:16:54 -06:00
roles.md docs: Add roles page under Account & Privacy section (#51413) 2026-03-13 10:48:54 -07:00
running-testing.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
semantic-tokens.md extension_host: Allow extensions to define semantic highlighting rules (#49282) 2026-03-02 17:54:53 +01:00
snippets.md docs: Remove outdated reference to simple-completion-language-server (#50732) 2026-03-04 18:45:52 +00:00
SUMMARY.md Remove text thread and slash command crates (#52757) 2026-03-31 17:55:05 +02:00
tab-switcher.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
tasks.md Don't save buffers by default when running tasks (#52976) 2026-04-02 13:09:29 +00:00
telemetry.md Docs/privacy documentation refresh (#50522) 2026-03-02 11:21:07 -08:00
terminal.md docs: SEO content improvements for AI section (#49128) 2026-02-13 13:05:57 -08:00
themes.md Add hotkeys and actions for toggle light and dark theme (#49027) 2026-03-12 21:35:42 +02:00
toolchains.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
troubleshooting.md feedback: Add action for listing installed extensions (#48664) 2026-04-16 07:45:38 +00:00
uninstall.md docs: Update guide to remove user data on macOS when uninstalling Zed (#52631) 2026-03-31 05:35:04 +00:00
update.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
vim.md docs: Update mentions to "assistant panel" (#53514) 2026-04-09 10:42:21 -03:00
visual-customization.md Move the worktree picker to the title bar + make it always visible (#54183) 2026-04-20 09:29:51 +00:00
windows.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00
worktree-trust.md docs: Apply documentation standards across all docs (#49177) 2026-02-17 20:58:17 -06:00