Built by @zed-industries on GitHub. This page was written by @iluxav from public sources, last updated for v1.22.0 (2026-09-30), and may lag behind new releases.
Write code with built-in AI agents and edit predictions, collaborate live with others, and work on remote machines over SSH, on macOS, Linux and Windows.
What you can do with it
Ask an AI agent in the editor to read, edit and run commands across your project, and review its changes.
Good to know
Needs a Zed account or your own API key for a model provider.
Present at v0.205.5
Run external coding agents such as Gemini CLI or Claude Code inside Zed through the Agent Client Protocol.
Present at v0.205.5
Get multi-line edit predictions as you type and accept them with Tab.
Present at v0.205.5
Use your own API keys for model providers such as Anthropic, OpenAI, Google AI, Mistral, xAI or OpenRouter, or local models through Ollama or LM Studio.
Present at v0.205.5
Edit code together in real time, talk in calls and share your screen through channels.
Present at v0.205.5
Stage, commit, view diffs and blame, and switch branches without leaving the editor.
Present at v0.205.5
Work on a project on a remote machine over SSH while the interface runs locally.
Present at v0.205.5
Edit with Vim or Helix style modal keybindings.
Present at v0.205.5
Show all 14
Debug programs with breakpoints and stepping through debug adapters.
Present at v0.205.5
Get completion, diagnostics and code navigation from language servers configured per language.
Present at v0.205.5
Run Zed on macOS, Linux and Windows.
Present at v0.205.5
Find files and text in resizable pickers that preview results as you type.
Since v1.9.0
Preview CSV, TSV, PSV and SSV files as tables you can sort, filter and copy from.
Since v1.17.2
Open a project inside a Dev Container defined in the repository.
Good to know
Initial support.
PreviewSince v0.219.4
Before you upgrade
Newest first
v1.22.02026-09-30
Closing the active dock moved from cmd-w/ctrl-w to ctrl-alt-w on all platforms; cmd-w/ctrl-w closes the active pane item.
The default base_keymap is Zed instead of VSCode; the VSCode keymap is now an overlay closer to VS Code, so users who set it explicitly see some bindings change (inline assistant on cmd-i/ctrl-i).
edit_prediction_conflict became edit_prediction && (showing_completions || in_leading_whitespace); keymaps migrate automatically but break if they relied on the two being exclusive. Tab in leading whitespace now accepts the prediction.
Action requiredAffects: Keymaps that use the edit_prediction or edit_prediction_conflict key contexts
Projects must be trusted before Zed runs project-specific code; set session.trust_all_worktrees to true to turn this off. Word completions are off in plain text and Markdown.
Python files start only basedpyright and ruff by default, and ruff organizes imports on save; set code_actions_on_format source.organizeImports.ruff to false to stop that.
Choose a different model for each subagent you start.
Details
A model parameter for spawn_agent, subagent compaction, GPT-6.1 Sol with your own key, a unified/split toggle for zed --diff. Closing the active dock moved to ctrl-alt-w; a top-level "..." in terminal.path_hyperlink_regexes now inserts inherited regexes; Threads Sidebar settings were regrouped (auto-migrated).
Stable v1.22.0.
Improved: Ask an AI agent in the editor to read, edit and run…Behavior changedAction required
A language server command picker, a setting that keeps the system awake during long agent turns, Claude Opus 5.5 and GPT-6 Astra, Sol and Luna with your own keys, faster rendering. The agent panel copies plain text with cmd-c/ctrl-c; Markdown preview font settings moved under markdown_preview (auto-migrated). Covers v1.20 and v1.21.
Also: Cursor movement animation, opening Markdown in rendered preview, Emmet wrap with abbreviation.
Stable v1.21.0.
Improved: Get completion, diagnostics and code navigation fro…Improved: Use your own API keys for model providers such as A…Behavior changed: Ask an AI agent in the editor to read, edit and run…
Call hierarchy, inline debugger values for C and C++, multi-select in the Git panel, language detection for untitled buffers. Project search runs as you type by default; f10/f11 step over and into while paused; older Gemini models were removed; GLib libraries left the Linux archives. Covers v1.18 and v1.19.
Also: Refreshed Markdown preview styling; File Finder history persists across sessions.
Stable v1.19.2.
Improved: Get completion, diagnostics and code navigation fro…Improved: Debug programs with breakpoints and stepping throug…Behavior changedAction required: Use your own API keys for model providers such as A…Behavior changed: Run Zed on macOS, Linux and Windows.
Preview CSV and TSV files as sortable, filterable tables.
Details
Table previews for CSV, TSV, PSV and SSV, Gemini 3.6 Flash, stash messages in the Git panel. The default OpenAI subscription model is GPT-5.6 Sol, OpenCode Free models left the built-in provider, and the ask_user tool is off by default. Covers v1.16 and v1.17.
Also: Setting for opening the terminal panel in new workspaces; lower memory use on large files.
Stable v1.17.2.
Added: Preview CSV, TSV, PSV and SSV files as tables you c…Behavior changed: Use your own API keys for model providers such as A…Behavior changed: Ask an AI agent in the editor to read, edit and run…
Run the agent's terminal commands and web fetches in a sandbox.
Details
Agent sandboxing, undo and redo for project panel file operations, Skip Hooks for commits, git.diff_base. The default base_keymap is now Zed instead of VSCode, and Copilot Chat users must sign in again. Covers v1.14 and v1.15.
Also: Drag files from the project panel to other apps on macOS and Linux Wayland.
Stable v1.15.0.
Improved: Ask an AI agent in the editor to read, edit and run…Improved: Stage, commit, view diffs and blame, and switch bra…Behavior changedAction required: Use your own API keys for model providers such as A…
Select several results at once in the File Finder and Text Finder.
Details
Multi-select in the finders, Staged and Unstaged grouping in the Git panel, branch picker filtering. Three deprecated Mistral models were removed; cmd-alt-f on macOS opens the Text Finder. Covers v1.12 and v1.13.
Stable v1.13.1.
Improved: Find files and text in resizable pickers that previ…Improved: Stage, commit, view diffs and blame, and switch bra…Action required: Use your own API keys for model providers such as A…
Review, stage, unstage or restore single hunks in Staged and Unstaged Changes views.
Details
Staged Changes and Unstaged Changes multibuffers, git.inline_blame.location, llama.cpp as a model provider. Format on save is off by default except for languages with official formatters. Covers v1.10 and v1.11.
Also: Preview pane in the project symbols picker; model providers, external agents and MCP servers moved into the settings editor.
Stable v1.11.3.
Improved: Stage, commit, view diffs and blame, and switch bra…Improved: Use your own API keys for model providers such as A…Behavior changed
Search files and text in resizable pickers that preview results as you type.
Details
Telescope-style resizable pickers with previews and a text finder (text finder: toggle), search in the agent panel, worktrees from the new-thread button, agent.terminal_init_command. git_panel.sort_by_path became git_panel.sort_by and git_panel.group_by. Covers v1.8 and v1.9.
Also: workspace: reset pane sizes; select inside or around delimiters.
Stable v1.9.0.
Added: Find files and text in resizable pickers that previ…Improved: Ask an AI agent in the editor to read, edit and run…Action required: Stage, commit, view diffs and blame, and switch bra…
Shorten a long agent conversation with /compact so it can keep going.
Details
Automatic and manual (/compact) context compaction, Fast mode for Anthropic and OpenAI models, single-file diff tabs and split diffs in commit history. Extensions can no longer download language servers, debuggers or MCP servers on 32-bit systems. Covers v1.6 and v1.7.
Also: Shareable skill links; commit title length warnings are off by default.
Stable v1.7.2.
Improved: Ask an AI agent in the editor to read, edit and run…Improved: Stage, commit, view diffs and blame, and switch bra…Action requiredBehavior changed: Edit code together in real time, talk in calls and…Behavior changed: Stage, commit, view diffs and blame, and switch bra…
Give the agent reusable skills and user-wide instructions in a global AGENTS.md.
Details
Agent skills and a global AGENTS.md; the rules library and @rule were replaced by skills and @skill. ACP extensions were removed and migrated to registry servers. Clickable LSP document links are on by default. Covers v1.4 and v1.5.
Also: New Mermaid renderer, base branch choice in branch diff, renaming threads in the sidebar.
Stable v1.5.3.
Improved: Ask an AI agent in the editor to read, edit and run…Action required: Ask an AI agent in the editor to read, edit and run…Behavior changed: Run external coding agents such as Gemini CLI or Cl…Improved: Get completion, diagnostics and code navigation fro…
Start a terminal agent thread from the sidebar or the agent panel.
Details
Terminal threads, a subagent_model setting, inline images and Mermaid in agent output, Git Graph remote support and branch history. The Vercel v0 provider, deprecated xAI and OpenAI models and the agent's open tool were removed; fuzzy-ruby-server is off by default. Covers v1.2 and v1.3.
Also: Helix buffer picker (space b); Copilot edit predictions no longer need a system Node.
Stable v1.3.5.
Improved: Ask an AI agent in the editor to read, edit and run…Improved: Stage, commit, view diffs and blame, and switch bra…Action required: Use your own API keys for model providers such as A…Behavior changed: Get completion, diagnostics and code navigation fro…
Zed 1.0 (2026-04-29). LSP code lenses ("code_lens": "on"). soft_wrap "preferred_line_length" is replaced by "bounded", the project_name setting was removed, and the hide_mouse value on_typing_and_movement became on_typing_and_action (auto-migrated). Covers v1.0 and v1.1.
Stable v1.1.5.
Improved: Get completion, diagnostics and code navigation fro…Action requiredAction required
Parallel agents, Claude Opus 4.7 with your own key, editor: toggle block comment, font size zoom with the scroll wheel (off by default), file finder matching terms in any order, focus follows mouse. The notification panel and the Fix with Assistant code action were removed. Covers v0.232 and v0.233.
Also: Search in Markdown preview; anchor links and footnotes in Markdown preview.
Stable v0.233.5.
Improved: Ask an AI agent in the editor to read, edit and run…Behavior changed: Ask an AI agent in the editor to read, edit and run…Behavior changed: Edit code together in real time, talk in calls and…
Screen sharing on Wayland, multi-line search and replace, Git status in the project panel, vim/emacs modelines, a native Dev Container implementation with extension support, channel favorites. Text Threads, the rodio audio backend and the Sweep proprietary edit prediction API were removed. Covers v0.230 and v0.231.
Also: Pasting files into the agent panel; split diffs switch to unified in narrow panes.
Stable v0.231.1.
Improved: Edit code together in real time, talk in calls and…Improved: Open a project inside a Dev Container defined in th…Action required: Ask an AI agent in the editor to read, edit and run…Action required: Get multi-line edit predictions as you type and acc…
Agent merge-conflict resolution, @-mention of the branch diff, 1M-token context for Claude Opus and Sonnet with your own key, Git panel change count badge and file icons, worktree rename and delete over SSH. Gemini 3 Pro Preview configurations migrate to Gemini 3.1 Pro. Covers v0.228 and v0.229.
Also: Align multiple cursors, pinch-to-zoom in the image viewer, easier unbinding of default keys.
Stable v0.229.0.
Improved: Ask an AI agent in the editor to read, edit and run…Improved: Use your own API keys for model providers such as A…Improved: Stage, commit, view diffs and blame, and switch bra…Action required: Get multi-line edit predictions as you type and acc…
Run several subagents in parallel from one agent thread.
Details
Parallel subagents, a Review Diff button that sends a branch diff to the agent, undo for reject all, self-hosted OpenAI-compatible edit prediction servers, Vercel AI Gateway. Built-in agents moved to the ACP Registry; deprecated Anthropic models and the debugger's stack trace multibuffer were removed. Covers v0.226 and v0.227.
Also: Diagnostic count badges in the project panel (off by default), git diff stats in the Git panel.
Stable v0.227.1.
Improved: Ask an AI agent in the editor to read, edit and run…Improved: Get multi-line edit predictions as you type and acc…Action required: Use your own API keys for model providers such as A…Behavior changed: Run external coding agents such as Gemini CLI or Cl…Behavior changed: Debug programs with breakpoints and stepping throug…
Split diffs, LSP semantic tokens, per-tool agent permissions, agent threads restored after restart, thinking effort controls. always_allow_tool_actions became tool_permissions.default; agent.single_file_review defaults to false; old OpenAI models were removed; Linux renders with wgpu. Covers v0.224 and v0.225.
Also: Mermaid diagrams in Markdown preview; Claude Code is now shown as Claude Agent.
Stable v0.225.9.
Improved: Stage, commit, view diffs and blame, and switch bra…Improved: Ask an AI agent in the editor to read, edit and run…Action required: Ask an AI agent in the editor to read, edit and run…Behavior changed: Ask an AI agent in the editor to read, edit and run…Action required: Use your own API keys for model providers such as A…Behavior changed: Run Zed on macOS, Linux and Windows.
Pick your edit prediction provider: GitHub Copilot, Ollama, Codestral, Sweep or Mercury Coder.
Details
Multiple edit prediction providers, Windows as an SSH remoting target, blocking of dangerous agent commands such as rm -rf /, Azure as a Git provider. The file picker shows hidden files by default. Covers v0.222 and v0.223.
Also: Image viewer zoom and pan, sending terminal selections to the agent, downloads from remote servers.
Stable v0.223.3.
Improved: Get multi-line edit predictions as you type and acc…Improved: Work on a project on a remote machine over SSH whil…Improved: Ask an AI agent in the editor to read, edit and run…Behavior changed
ACP Registry for agents, queued agent messages by default, MCP servers and local terminals in remote projects, a unified Git picker for branches, worktrees and stashes. Covers v0.220 and v0.221.
Also: Vim-style tag stack for go to definition, EditorConfig inheritance, Markdown outline.
Stable v0.221.4.
Improved: Run external coding agents such as Gemini CLI or Cl…Improved: Work on a project on a remote machine over SSH whil…Improved: Stage, commit, view diffs and blame, and switch bra…Behavior changed: Ask an AI agent in the editor to read, edit and run…
Initial Dev Containers support and worktree trust (turn off with session.trust_all_worktrees). Subpixel text rendering on Windows and Linux, a Git tree view, git: create pull request. AcceptPartialEditPrediction was split in two; word completions are off in plain text and Markdown. Covers v0.218 and v0.219.
Also: Pinned agent models with alt-tab cycling, queued agent messages, restart or stop single language servers.
Stable v0.219.4; Dev Containers are an initial version.
Added: Open a project inside a Dev Container defined in th…Improved: Run Zed on macOS, Linux and Windows.Improved: Stage, commit, view diffs and blame, and switch bra…Action required: Get multi-line edit predictions as you type and acc…Behavior changedBehavior changed: Edit with Vim or Helix style modal keybindings.Action required: Get completion, diagnostics and code navigation fro…
File History view, word-based diff highlighting, deleting branches, git remotes, command palette history. Old Gemini 1.5 and 2.0 models were removed; three non-working collab toggle actions were removed; a preview tab setting was renamed. Covers v0.216 and v0.217.
Also: Grok 4.1 Fast models; RotateSelectionsForward/Backward actions.
Stable v0.217.1.
Improved: Stage, commit, view diffs and blame, and switch bra…Action required: Use your own API keys for model providers such as A…Action required: Edit code together in real time, talk in calls and…Action required
Set a default model for Claude Code, Codex CLI and Gemini CLI when you start them in Zed.
Details
Default models for built-in external agents, agent server extensions over SSH, rainbow brackets, uv workspace detection, GPT-5.1 for BYOK. On Linux a window_decorations setting replaces the ZED_WINDOW_DECORATIONS variable. Covers v0.214 and v0.215.
Also: Vim range write commands, project_panel.sort_mode, pretty TypeScript errors.
Stable v0.215.3.
Improved: Run external coding agents such as Gemini CLI or Cl…Improved: Work on a project on a remote machine over SSH whil…Action required: Run Zed on macOS, Linux and Windows.
Git worktree management, git: pull rebase, GitLab and Gitee avatars in blame, Gemini 3 Pro, sticky scroll. relative_line_numbers is now an enum (enabled, disabled, wrapped); Markdown keeps trailing whitespace on save. Covers v0.212 and v0.213.
Also: Deep links to individual settings; multi-word snippet prefixes; clicking a multibuffer header now collapses the file.
Stable v0.213.3.
Improved: Stage, commit, view diffs and blame, and switch bra…Improved: Use your own API keys for model providers such as A…Action requiredBehavior changed
Diff your current branch against main with one action.
Details
git: branch diff action and a Windows Arm64 build. For Python only basedpyright and ruff start by default, and ruff organizes imports on save. agent: quote selection is now agent: add selection to thread. Covers v0.210 and v0.211.
Also: Line ending indicator in the status bar (off by default), keymap editor reachable from the command palette.
Stable v0.211.4.
Improved: Stage, commit, view diffs and blame, and switch bra…Improved: Run Zed on macOS, Linux and Windows.Behavior changed: Get completion, diagnostics and code navigation fro…Action required: Ask an AI agent in the editor to read, edit and run…
Windows builds (v0.208), Codestral as an edit prediction provider (v0.209). format_on_save now only takes "on" or "off" with format steps under formatter (auto-migrated); agent_font_size is now agent_ui_font_size. Covers v0.208 and v0.209.
Also: Terminal keeps the selection after copying; the Give Feedback modal moved into the Help menu.
Stable v0.209.4; Windows from v0.208.
Limit lifted: Run Zed on macOS, Linux and Windows.Improved: Get multi-line edit predictions as you type and acc…Action requiredAction required: Ask an AI agent in the editor to read, edit and run…Behavior changed
Read sharper text on Linux after a font rendering update.
Details
Improved font rendering on Linux, a git: rename branch action and GitHub avatars in the blame gutter. Some settings are no longer read from project settings files, the /cargo-workspace slash command is gone, and terminal breadcrumbs are off by default. Covers v0.206 and v0.207.
Also: Vim commands for the project panel, agent profile search, Markdown links embedded on paste.
Stable v0.207.3.
Improved: Run Zed on macOS, Linux and Windows.Improved: Stage, commit, view diffs and blame, and switch bra…Action requiredAction required: Ask an AI agent in the editor to read, edit and run…Behavior changed
Write code with an AI agent, edit predictions and live collaboration in one editor.
Details
What Zed offered up to v0.205: an agent panel and external agents over ACP, edit predictions, your own model API keys, real-time collaboration with channels, Git tools, SSH remote development, Vim and Helix modes, a debugger and language servers, on macOS and Linux.
Downloads for macOS and Linux, or Linux package managers.
Added: Ask an AI agent in the editor to read, edit and run…Added: Run external coding agents such as Gemini CLI or Cl…Added: Get multi-line edit predictions as you type and acc…Added: Use your own API keys for model providers such as A…Added: Edit code together in real time, talk in calls and…Added: Stage, commit, view diffs and blame, and switch bra…Added: Work on a project on a remote machine over SSH whil…Added: Edit with Vim or Helix style modal keybindings.Added: Debug programs with breakpoints and stepping throug…Added: Get completion, diagnostics and code navigation fro…Added: Run Zed on macOS, Linux and Windows.