Zed Editor Configuration Guide: Autosave, Prettier, Terminal Font, and Formatting Made Easy

Introduction

Zed is a high-performance, collaborative code editor created by the same minds behind Atom and Tree-sitter. It is also open-source. Its key strengths are:

1. Stay in Flow Productive coding starts with a tool that stays out of your way. Zed combines the power of an IDE with the responsiveness of a lightweight editor for productivity you can feel under your fingertips.

2. Engineered for performance Zed efficiently leverages every CPU core and your GPU to start instantly, load files in a blink, and respond to your keystrokes on the next display refresh. Unrelenting performance keeps you in flow and makes other tools feel slow.

3. Intelligence on tap Save time and keystrokes by generating code with AI. Zed supports GitHub Copilot out of the box, and you can use GPT-4 to generate or refactor code by pressing ctrl-enter and typing a natural language prompt. Interact with the model conversationally without switching context in the built-in assistant panel, then reference your conversation during inline generation.

4. Language-aware Zed maintains a full syntax tree for every buffer as you type, enabling precise code highlighting, auto-indent, a searchable outline view, and structural selection. Zed also speaks the Language Server Protocol to provide autocompletion, code navigation, diagnostics, and refactorings.

Getting Started

Download the installer

MacOS

You can obtain the stable builds via the download page. If you want to download our preview build, you can find it on its releases page After the first manual installation, Zed will periodically check for and install updates automatically for you.

You can also install Zed stable via Homebrew:

bash
brew install --cask zed

As well as Zed preview:

bash
brew install --cask zed@preview

Linux

For most people, the easiest way to install Zed is through our installation script:

bash
curl https://zed.dev/install.sh | sh

If you'd like to help us test our new features, you can also install our preview build:

bash
curl https://zed.dev/install.sh | ZED_CHANNEL=preview sh

This script supports x86_64 and AArch64, as well as common Linux distributions: Ubuntu, Arch, Debian, RedHat, CentOS, Fedora, and more.

If this script is not suitable for your use case or you encounter issues running Zed, please refer to the Linux-specific documentation.

Sample Configuration File

Zed editor version number: 0.163.3

json
{
  "ssh_connections": [
    {
      "host": "debian.local",
      "username": "root",
      "projects": [
        {
          "paths": ["/root"]
        }
      ]
    }
  ],
  "assistant": {
    "default_model": {
      "provider": "zed.dev",
      "model": "claude-3-5-sonnet-20240620"
    },
    "version": "2"
  },
  "theme": "One Dark Pro",
  "telemetry": {
    "diagnostics": false,
    "metrics": false
  },
  "autosave": "on_window_change",
  // UI
  "ui_font_size": 16,
  "ui_font_family": "Roboto Mono",
  // Editor
  "buffer_font_size": 16,
  "buffer_font_family": "Roboto Mono",
  "buffer_font_features": {
    "calt": false
  },
  "toolbar": {
    // Whether to show breadcrumbs.
    "breadcrumbs": true,
    // Whether to show quick action buttons.
    "quick_actions": false,
    // Whether to show the Selections menu in the editor toolbar
    "selections_menu": false
  },
  "tabs": {
    "git_status": true
  },
  // Other
  "confirm_quit": true,
  "inline_completions": {
    "disabled_globs": [".env"]
  },
  "current_line_highlight": "all",
  "chat_panel": {
    // Whether to show the chat panel button in the status bar.
    "button": false
  },
  "outline_panel": {
    "button": false
  },
  "notification_panel": {
    // Whether to show the notification panel button in the status bar.
    "button": false
  },
  "soft_wrap": "editor_width",
  "terminal": {
    "button": true,
    "copy_on_select": true,
    "blinking": "on",
    "font_family": "Roboto Mono"
  },
  "features": {
    "inline_completion_provider": "none"
  },
  // "assistant": {
  //   // Version of this setting.
  //   "default_model": {
  //     "provider": "openai",
  //     "model": "gpt-4o-mini"
  //   },
  //   "version": "2",
  //   // Whether the assistant is enabled.
  //   "enabled": true,
  //   // Whether to show the assistant panel button in the status bar.
  //   "button": true,
  //   // Where to dock the assistant panel. Can be 'left', 'right' or 'bottom'.
  //   "dock": "right",
  //   // AI provider.
  //   "provider": null
  // },
  "collaboration_panel": {
    "button": false
  },
  "preferences": {
    "includeInlayParameterNameHints": "all",
    "includeInlayParameterNameHintsWhenArgumentMatchesName": true,
    "includeInlayFunctionParameterTypeHints": true,
    "includeInlayVariableTypeHints": true,
    "includeInlayVariableTypeHintsWhenTypeMatchesName": true,
    "includeInlayPropertyDeclarationTypeHints": true,
    "includeInlayFunctionLikeReturnTypeHints": true,
    "includeInlayEnumMemberValueHints": true
  },
  "languages": {
    "JavaScript": {
      "code_actions_on_format": {
        "source.fixAll.eslint": true
      }
    },
    "TypeScript": {
      "code_actions_on_format": {
        "source.fixAll.eslint": true
      }
    }
  },
  "prettier": {
    // Whether to consider prettier formatter or not when attempting to format a file.
    "allowed": true,
    //
    // Use regular Prettier json configuration.
    // If Prettier is allowed, Zed will use this for its Prettier instance for any applicable file, if
    // the project has no other Prettier installed.
    "plugins": [],
    //
    // Use regular Prettier json configuration.
    // If Prettier is allowed, Zed will use this for its Prettier instance for any applicable file, if
    // the project has no other Prettier installed.
    "tabWidth": 2,
    "bracketSpacing": true,
    "trailingComma": "es5",
    "semi": false,
    "jsxSingleQuote": false,
    "singleQuote": true
  }
}

This is the editor UI after configuration is completed.

Configuration Documentation

Theme Configuration

The theme settings for the UI.

• theme: Object containing theme-related settings.
  • mode: Defines the theme mode.
    • "system": Matches the system's appearance.
    • "light": Uses the theme specified by the light field.
    • "dark": Uses the theme specified by the dark field.
  • light: The light theme name (default: "One Light").
  • dark: The dark theme name (default: "One Dark").

Keymap Configuration

Base key bindings for the editor.

• base_keymap: Specifies the keymap to use. Acceptable values:
  1. "VSCode"
  2. "Atom"
  3. "JetBrains"
  4. "None"
  5. "SublimeText"
  6. "TextMate"

Default: "VSCode"

Features

Settings for enabling or disabling global features.

• features: Object containing feature-related configurations.
  • inline_completion_provider: Defines the inline completion provider to use (default: "copilot").

Editor Font Configuration

Settings for the text font in the editor.

• buffer_font_family: Primary font for rendering text (default: "Zed Plex Mono").
• buffer_font_fallbacks: Font fallbacks for the editor (default: null).
• buffer_font_features: OpenType features for text rendering.
  • Example:
    • "calt": Disable ligatures if set to false.
• buffer_font_size: Font size for editor text (default: 15).
• buffer_font_weight: Font weight for editor text, between 100 and 900 (default: 400).
• buffer_line_height: Line height options for the editor:
  1. "comfortable": Comfortable for reading (1.618).
  2. "standard": Standard line height (1.3).
  3. {"custom": <value>}: Custom line height.

Default: "comfortable"

UI Font Configuration

Settings for the text font in the user interface.

• ui_font_family: Primary font for UI text (default: "Zed Plex Sans").
  • Use ".SystemUIFont" to match the system font.
• ui_font_fallbacks: Font fallbacks for the UI (default: null).
• ui_font_features: OpenType features for UI text.
  • Example:
    • "calt": Disable ligatures if set to false.

UI Font Configuration (Extended)

Settings for the user interface font.

• ui_font_weight: Weight of the UI font in standard CSS units, ranging from 100 to 900 (default: 400).
• ui_font_size: Default font size for text in the UI (default: 16).

Code Styling

Visual adjustments for unused code.

• unnecessary_code_fade: Opacity factor for fading unused code. A value of 0 means fully visible, and 1 means fully faded (default: 0.3).

Pane Styling

Settings related to the active and inactive panes.

• active_pane_modifiers: Object for customizing active pane styles.
  • magnification: Scale factor for the active pane size (default: 1.0).
  • border_size: Inset border size of the active pane, in pixels (default: 0.0).
  • inactive_opacity: Opacity of inactive panes, clamped to [0.0, 1.0] (default: 1.0).

Pane Split Directions

Settings for controlling pane split behavior.

• pane_split_direction_horizontal: Direction to split panes horizontally (default: "up").
• pane_split_direction_vertical: Direction to split panes vertically (default: "left").

Centered Layout

Settings for the centered workspace layout.

• centered_layout: Object defining padding for the central pane.
  • left_padding: Relative width of the left padding (default: 0.2).
  • right_padding: Relative width of the right padding (default: 0.2).

Multi-Cursor Modifier

Keybinding for adding multiple cursors.

• multi_cursor_modifier: Key used for multi-cursor functionality. Supported values:
  • "alt"
  • "cmd_or_ctrl" (also aliased as "cmd" and "ctrl")

Default: "alt"

Vim Mode

• vim_mode: Enable or disable Vim modes and key bindings (default: false).

Hover Popover

• hover_popover_enabled: Show an informational hover box when moving the mouse over symbols (default: true).

Quit Confirmation

• confirm_quit: Confirm before quitting Zed (default: false).

Restore on Startup

• restore_on_startup: Determines what to restore when Zed is launched.
  • "last_session": Restore the last closed project.

Drop Target Size

• drop_target_size: Size of the drop target in the editor (default: 0.2).

Window Closing Behavior

• when_closing_with_no_tabs: Determines the window behavior when no tabs are present.
  • "platform_default": Follow the platform's convention (default).
  • "close_window": Always close the window.
  • "keep_window_open": Never close the window.

System Path Prompts

• use_system_path_prompts: Use system dialogs for Open and Save As. When false, Zed uses keyboard-first pickers (default: true).

Cursor Behavior

• cursor_blink: Whether the cursor blinks in the editor (default: true).
• cursor_shape: Shape of the cursor in the editor.
  • "bar": Vertical bar.
  • "block": Block surrounding the following character.
  • "underline": Underline below the following character.
  • "hollow": Hollow box around the following character.

Default: "bar"

Current Line Highlighting

• current_line_highlight: Highlighting behavior for the current line.
  • "none": No highlighting.
  • "gutter": Highlight gutter area.
  • "line": Highlight editor area.
  • "all": Highlight the entire line (default).

Auto-Completion

• show_completions_on_input: Automatically pop the completions menu while typing (default: true).
• show_completion_documentation: Show inline documentation in the completions menu (default: true).
• completion_documentation_secondary_query_debounce: Delay (ms) before re-querying the language server for additional documentation (default: 300).

Signature Help

• auto_signature_help: Automatically show method signatures in the editor when inside parentheses (default: false).
• show_signature_help_after_edits: Show signature help after a completion or bracket pair insertion. If auto_signature_help is enabled, this is treated as enabled too (default: false).

Wrap Guides

• show_wrap_guides: Show wrap guides (vertical rulers) in the editor.
  • Guides appear based on the preferred_line_length setting when soft_wrap is enabled (default: true).

Wrap Guides

• wrap_guides: Character counts at which wrap guides are shown in the editor. Default is an empty array [].

Privacy Settings

• redact_private_values: Hide variable values in private files (default: false).
• private_files: Globs matching file paths to identify private files. Default includes patterns like .env*, .pem, .key, and secrets.yml.

Editor Behavior

• expand_excerpt_lines: Number of lines to expand in excerpts within the multibuffer (default: 3).
• use_on_type_format: Use Language Server Protocol (LSP) for on-type formatting after trigger symbols (default: true).
• use_autoclose: Automatically insert matching closing characters (default: true).
• use_auto_surround: Automatically surround selected text when typing opening characters (default: true).
• auto_indent_on_paste: Adjust pasted content indentation contextually (default: true).
• always_treat_brackets_as_autoclosed: Treat all closing characters as autoclosed, regardless of insertion method (default: false).

Inline Completions

• show_inline_completions: Show inline completions immediately (default: true).
• inline_completions_disabled_in: Language scopes where inline completions are disabled (default: []).

Whitespace Visibility

• show_whitespaces: Control visibility of tabs and spaces:
  • "selection": Show only in selected text (default).
  • "none": Do not show any tabs or spaces.
  • "all": Show all invisible symbols.
  • "boundary": Show whitespaces at boundaries (e.g., tabs, adjacent to edges or other whitespaces).

Calls

• calls.mute_on_join: Join calls with the microphone muted (default: false).
• calls.share_on_join: Share your project when first joining a channel (default: false).

Toolbar

• toolbar.breadcrumbs: Show breadcrumbs (default: true).
• toolbar.quick_actions: Show quick action buttons (default: true).
• toolbar.selections_menu: Show Selections menu in the editor toolbar (default: true).

Scrollbar

• scrollbar.show: When to show the scrollbar:
  • "auto": Show based on importance or system behavior (default).
  • "system": Follow system's behavior.
  • "always": Always show the scrollbar.
  • "never": Never show the scrollbar.
• scrollbar.cursors: Show cursor positions in the scrollbar (default: true).
• scrollbar.git_diff: Show Git diff indicators in the scrollbar (default: true).
• scrollbar.search_results: Show search results in the scrollbar (default: true).
• scrollbar.selected_symbol: Show selected symbol occurrences in the scrollbar (default: true).
• scrollbar.diagnostics: Show diagnostic indicators in the scrollbar (default: true).

Miscellaneous Settings

• middle_click_paste: Enable middle-click paste on Linux (default: true).
• double_click_in_multibuffer: Behavior for double-clicking excerpts in the multibuffer:
  • "select": Select the whole word (default).
  • "open": Open the excerpt as a new buffer in a new tab.
• gutter.line_numbers: Show line numbers in the gutter (default: true).
• gutter.code_actions: Show code action buttons in the gutter (default: true).
• gutter.runnables: Show runnable buttons in the gutter (default: true).
• gutter.folds: Show fold buttons in the gutter (default: true).

Indent Guides

• indent_guides.enabled: Show indent guides in the editor (default: true).
• indent_guides.line_width: Width of indent guides in pixels (range: 1–10, default: 1).
• indent_guides.active_line_width: Width of the active indent guide in pixels (range: 1–10, default: 1).
• indent_guides.coloring: Determines coloring of indent guides:
  • "disabled": No color.
  • "fixed": Fixed color (default).
  • "indent_aware": Color varies by indent level.
• indent_guides.background_coloring: Determines background coloring of indent guides:
  • "disabled": No background coloring (default).
  • "indent_aware": Background color changes with indent level.

Scrolling Behavior

• scroll_beyond_last_line: Scroll behavior beyond the last line:
  • "one_page": Allows one page of extra scrolling space.
• vertical_scroll_margin: Number of lines to keep visible above/below the cursor when scrolling (default: 3).
• scroll_sensitivity: Multiplier for scroll sensitivity (default: 1.0).

Line Numbers and Search

• relative_line_numbers: Use relative line numbers in the editor (default: false).
• search_wrap: Enable search wrapping around the file (default: true).
• search: Default search options:
  • whole_word: Match whole words only (default: false).
  • case_sensitive: Search is case-sensitive (default: false).
  • include_ignored: Include ignored files in search (default: false).
  • regex: Use regex in search (default: false).
• seed_search_query_from_cursor: Populate search queries from text under the cursor:
  • "always": Always populate (default).
  • "selection": Populate only when text is selected.
  • "never": Never populate.
• use_smartcase_search: Automatically toggle case sensitivity based on query case (default: false).

Inlay Hints

• inlay_hints.enabled: Enable inlay hints globally (default: false).
• inlay_hints.show_type_hints: Show type hints (default: true).
• inlay_hints.show_parameter_hints: Show parameter hints (default: true).
• inlay_hints.show_other_hints: Show other hints (default: true).
• inlay_hints.show_background: Show background for inlay hints (default: false).
• inlay_hints.edit_debounce_ms: Debounce delay for hints after editing (default: 700 ms).
• inlay_hints.scroll_debounce_ms: Debounce delay for hints after scrolling (default: 50 ms).

Project Panel

• project_panel.button: Show project panel button in the status bar (default: true).
• project_panel.default_width: Default width of the project panel in pixels (default: 240).
• project_panel.dock: Dock location of the project panel:
  • "left": Dock on the left (default).
  • "right": Dock on the right.
• project_panel.file_icons: Show file icons (default: true).
• project_panel.folder_icons: Show folder icons or chevrons (default: true).
• project_panel.git_status: Show Git status in the project panel (default: true).
• project_panel.indent_size: Indentation for nested items in pixels (default: 20).
• project_panel.auto_reveal_entries: Automatically reveal entries in the project panel (default: true).
• project_panel.auto_fold_dirs: Automatically fold directories with only one subdirectory (default: true).

Project Panel Scrollbar

• project_panel.scrollbar.show: When to show the scrollbar in the project panel:
  • null: Inherit from editor settings (default).
  • "auto": Follow system behavior.
  • "system": Match system behavior.
  • "always": Always show the scrollbar.
  • "never": Never show the scrollbar.

Project Panel Diagnostics

• project_panel.show_diagnostics: Files to mark based on diagnostic errors/warnings:
  • "off": Do not mark files.
  • "errors": Mark files with errors only.
  • "all": Mark files with errors and warnings (default).

Project Panel Indent Guides

• project_panel.indent_guides.show: Show indent guides in the project panel:
  • "always": Always show indent guides (default).
  • "never": Never show indent guides.

Outline Panel

• outline_panel.button: Show the outline panel button in the status bar (default: true).
• outline_panel.default_width: Default width of the outline panel (default: 300).
• outline_panel.dock: Dock location of the outline panel:
  • "left": Dock on the left (default).
  • "right": Dock on the right.
• outline_panel.file_icons: Show file icons in the outline panel (default: true).
• outline_panel.folder_icons: Show folder icons/chevrons (default: true).
• outline_panel.git_status: Show Git status in the outline panel (default: true).
• outline_panel.indent_size: Indentation for nested items in pixels (default: 20).
• outline_panel.auto_reveal_entries: Automatically reveal active entries in the outline panel (default: true).
• outline_panel.auto_fold_dirs: Automatically fold single-directory directories (default: true).

Outline Panel Indent Guides

• outline_panel.indent_guides.show: Show indent guides in the outline panel:
  • "always": Always show indent guides (default).
  • "never": Never show indent guides.

Outline Panel Scrollbar

• outline_panel.scrollbar.show: When to show the scrollbar:
  • null: Inherit from editor settings (default).
  • "auto": Show scrollbar based on importance/system behavior.
  • "system": Match system settings.
  • "always": Always show scrollbar.
  • "never": Never show scrollbar.

Collaboration Panel

• collaboration_panel.button: Show collaboration panel button in the status bar (default: true).
• collaboration_panel.dock: Dock location of the collaboration panel:
  • "left": Dock on the left (default).
  • "right": Dock on the right.
• collaboration_panel.default_width: Default width of the collaboration panel (default: 240).

Chat Panel

• chat_panel.button: Show chat panel button in the status bar (default: true).
• chat_panel.dock: Dock location of the chat panel:
  • "left": Dock on the left.
  • "right": Dock on the right (default).
• chat_panel.default_width: Default width of the chat panel (default: 240).

Message Editor

• message_editor.auto_replace_emoji_shortcode: Automatically replace emoji shortcodes with emoji characters (default: true).

Notification Panel

• notification_panel.button: Show notification panel button in the status bar (default: true).
• notification_panel.dock: Dock location of the notification panel:
  • "left": Dock on the left.
  • "right": Dock on the right (default).
• notification_panel.default_width: Default width of the notification panel (default: 380).

Assistant

• assistant.version: Version of the assistant settings (default: "2").
• assistant.enabled: Enable assistant features (default: true).
• assistant.show_hints: Show inline hints for assistant keybindings (default: true).
• assistant.button: Show assistant panel button in the status bar (default: true).
• assistant.dock: Dock location of the assistant panel:
  • "left", "right" (default), or "bottom".
• assistant.default_width: Default width when docked left/right (default: 640).
• assistant.default_height: Default height when docked at the bottom (default: 320).
• assistant.default_model: Default model settings:
  • provider: "zed.dev" (default).
  • model: "claude-3-5-sonnet" (default).

Slash Commands

• slash_commands.docs.enabled: Enable the /docs command (default: false).
• slash_commands.project.enabled: Enable the /project command (default: false).

Miscellaneous Settings

• show_call_status_icon: Show screen-sharing icon in the OS status bar (default: true).
• enable_language_server: Enable language servers for code intelligence (default: true).
• linked_edits: Perform linked edits on associated ranges (default: true).

Language Servers

• language_servers: List of language servers to use for all languages (customizable).

Autosave Settings

• autosave: Determines when to auto-save buffers:
  • "off": Never auto-save (default).
  • "on_window_change": Save when switching Zed windows.
  • "on_focus_change": Save when switching buffers.
  • { "after_delay": {"milliseconds": 500} }: Save after specified idle time.

Tab Bar Settings

• tab_bar.show: Show the tab bar in the editor (default: true).
• tab_bar.show_nav_history_buttons: Show navigation history buttons in the tab bar (default: true).

Tabs Settings

• tabs.git_status: Show Git status colors in the editor tabs (default: false).
• tabs.close_position: Position of the close button on the editor tabs:
  • "left": Close button on the left.
  • "right": Close button on the right (default).
• tabs.file_icons: Show file icons in the editor tabs (default: false).
• tabs.activate_on_close: What to do after closing the current tab:
  • "History": Activate the tab that was open previously (default).
  • "Neighbour": Activate the neighboring tab (prefers the right one if available).

Preview Tabs Settings

• preview_tabs.enabled: Enable preview tabs for quickly viewing files without cluttering the workspace (default: true).
• preview_tabs.enable_preview_from_file_finder: Open tabs in preview mode when selected from the file finder (default: false).
• preview_tabs.enable_preview_from_code_navigation: Replace preview tab when code navigation is used (default: false).

File Finder Settings

• file_finder.file_icons: Show file icons in the file finder (default: true).
• file_finder.modal_max_width: Determines how much space the file finder can take up:
  • "small": Fixed width (default).
  • "medium": Medium width.
  • "large": Large width.
  • "xlarge": Extra large width.
  • "full": Fullscreen width, no horizontal padding.

File Save Settings

• remove_trailing_whitespace_on_save: Remove trailing whitespace from lines before saving the file (default: true).
• extend_comment_on_newline: Start a new line with a comment if the previous line is a comment (default: true).
• ensure_final_newline_on_save: Ensure there's a single newline at the end of a file when saving (default: true).
• format_on_save: Perform a buffer format before saving:
  • "off": No format on save.
  • "on": Format on save (default).
  • "auto": Format automatically based on the language server or other tools.

Formatter Settings

• formatter: Choose how to format code:
  • "language_server": Format code using the current language server.
  • { "external": { "command": "prettier", "arguments": ["--stdin-filepath", "{buffer_path}"] } }: Use an external command for formatting.
  • "prettier": Use Zed's Prettier integration.
  • "auto": Auto format using Prettier or fallback to the language server (default).

Soft-Wrap Settings

• soft_wrap: How to soft-wrap long lines of text:
  • "none": Prefer a single line, unless an overly long line is encountered (default).
  • "prefer_line": Deprecated, same as "none".
  • "editor_width": Soft wrap lines that overflow the editor.
  • "preferred_line_length": Soft wrap lines at the preferred line length.
  • "bounded": Soft wrap lines at the preferred line length or the editor width (whichever is smaller).
• preferred_line_length: The column at which to soft-wrap lines when soft-wrap is enabled (default: 80).

Tab Settings

• hard_tabs: Whether to use tab characters for indentation instead of multiple spaces (default: false).
• tab_size: Number of columns a tab should occupy (default: 4).

Telemetry Settings

• telemetry.diagnostics: Send debug information such as crash reports (default: true).
• telemetry.metrics: Send anonymized usage data like language usage (default: true).

Auto Update Setting

• auto_update: Automatically update Zed (default: true).

Diagnostics Settings

• diagnostics.include_warnings: Show warnings by default (default: true).

File Scan Exclusions

• file_scan_exclusions: List of files or globs that should be excluded from file scanning, file tree, and search:
  • **/.git
  • **/.svn
  • **/.hg
  • **/CVS
  • **/.DS_Store
  • **/Thumbs.db
  • **/.classpath
  • **/.settings

Git Settings

• git.git_gutter: Controls whether the git gutter is shown:
  • "tracked_files": Show the gutter for tracked files.
  • "hide": Hide the gutter.
• git.inline_blame.enabled: Enable inline blame information in the currently focused line (default: true).
• git.inline_blame.delay_ms: Delay before showing the inline blame information (default: 600 ms).
• git.inline_blame.show_commit_summary: Whether to display the commit summary inline (default: false).
• git.inline_blame.min_column: Minimum column number to show inline blame information (default: 0).

Direnv Configuration

• load_direnv: How to load direnv configuration:
  • "direct": Load via direnv export json.
  • "shell_hook": Load through the shell hook (for POSIX shells and fish).

Inline Completions Settings

• inline_completions.disabled_globs: List of files or globs where inline completions are disabled:
  • ".env"

Journal Settings

• journal.path: Directory where journal entries are stored (default: ~).
• journal.hour_format: Hour format for displaying times:
  • "hour12": 12-hour format.
  • "hour24": 24-hour format (default).

Terminal Settings

• terminal.shell: What shell to use when opening a terminal:
  • "system": Use the system's default shell configuration.
  • { "program": "sh" }: Use a specific shell program.
  • { "with_arguments": { "program": "/bin/bash", "args": ["--login"] } }: Use a shell program with arguments.
• terminal.dock: Where to dock the terminal panel:
  • "left", "right", "bottom" (default: "bottom").
• terminal.default_width: Default width when the terminal is docked to the left or right (default: 640).
• terminal.default_height: Default height when the terminal is docked to the bottom (default: 320).
• terminal.working_directory: Working directory when launching the terminal:
  • "current_project_directory": Use the current project's directory (default).
  • "first_project_directory": Use the first project in the workspace.
  • "always_home": Always use the platform's home directory.
  • { "always": { "directory": "~/zed/projects/" } }: Use a specific directory.
• terminal.blinking: Control cursor blinking behavior:
  • "off": Never blink the cursor.
  • "terminal_controlled": Allow terminal to control blinking.
  • "on": Always blink the cursor.
• terminal.cursor_shape: Default cursor shape in the terminal:
  • "block": Block cursor.
  • "bar": Vertical bar cursor.
  • "underline": Underline cursor.
  • "hollow": Hollow cursor.
  • Default: "block".

Alternate Scroll Mode

• Description: Determines whether Alternate Scroll mode (code: ?1007) is active by default. This mode converts mouse scroll events into up/down key presses when in the alternate screen (e.g., when running applications like vim or less).
• Values:
  • "on": Default alternate scroll mode is enabled.
  • "off": Default alternate scroll mode is disabled.
• Current Setting: off

Option Key Behavior

• Description: Defines whether the option key behaves as the meta key.
• Values:
  • false: Relies on default platform handling of the option key (on macOS, this means generating certain Unicode characters).
  • true: Makes the option key behave as a 'meta' key (e.g., for Emacs).
• Current Setting: false

Copy on Select

• Description: Determines if selecting text in the terminal automatically copies it to the system clipboard.
• Current Setting: false

Terminal Button in Status Bar

• Description: Specifies whether to show the terminal button in the status bar.
• Current Setting: true

Environment Variables

• Description: Any key-value pairs added here will be included in the terminal's environment. Use : to separate multiple values.
• Current Setting: Empty

Line Height

• Description: Configures the terminal's line height.
• Values:
  • "comfortable": Line height that's comfortable for reading (1.618).
  • "standard": Standard line height (1.3), useful for TUIs, especially with box characters.
  • "custom": Custom line height.
• Current Setting: "comfortable"

Python Virtual Environment Detection

• Description: Activates the Python virtual environment (if found) in the terminal's working directory.
• Current Setting: Enabled, with default directories .env, env, .venv, and venv to search for virtual environments.

Toolbar Settings

• Description: Specifies whether to display the terminal title in its toolbar.
• Current Setting: true

Font Settings

• Description: Configures the terminal's font size and family. If not set, the terminal defaults to matching the buffer's font size and family.
• Current Setting: Not specified (defaults applied).

Scrollback Buffer

• Description: Sets the maximum number of lines in the terminal's scrollback buffer.
• Default Setting: 10,000 lines
• Maximum Setting: 100,000 lines (values greater than this will be treated as 100,000)
• Current Setting: Not specified (defaults applied).

Code Actions and Tasks

Code Actions on Format

• Description: Settings related to actions performed on code formatting.
• Current Setting: Not specified.

Task Variables

• Description: Variables related to running tasks.
• Current Setting: Empty.

File Types

File Associations

• Description: Defines the file types and extensions associated with different languages.
• Current Setting:
  • Plain Text: txt
  • JSONC: **/.zed/**/*.json, **/zed/**/*.json, **/Zed/**/*.json
  • Shell Script: .env.*

Node Settings

Node Version

• Description: Defines which version of Node.js Zed should use.
• Current Setting: Default (uses system version, can be overridden).

Auto Install Extensions

• Description: Extensions that Zed should automatically install on startup.
• Current Setting:
  • HTML: true

Language Settings

Astro

• Language Servers: astro-language-server, ...
• Prettier:
  • Allowed: true
  • Plugins: prettier-plugin-astro

Blade

• Prettier:
  • Allowed: true

C

• Format on Save: off
• Use on Type Format: false

C++

• Format on Save: off
• Use on Type Format: false

CSS

• Prettier:
  • Allowed: true

Dart

• Tab Size: 2

Diff

• Remove Trailing Whitespace on Save: false
• Ensure Final Newline on Save: false

Elixir

• Language Servers: elixir-ls, !next-ls, !lexical, ...

Erlang

• Language Servers: erlang-ls, !elp, ...

Go

• Code Actions on Format:
  • source.organizeImports: true

GraphQL

• Prettier:
  • Allowed: true

HEEX

• Language Servers: elixir-ls, !next-ls, !lexical, ...

HTML

• Prettier:
  • Allowed: true

Java

• Prettier:
  • Allowed: true
  • Plugins: prettier-plugin-java

JavaScript

• Language Servers: !typescript-language-server, vtsls, ...
• Prettier:
  • Allowed: true

JSON

• Prettier:
  • Allowed: true

JSONC

• Prettier:
  • Allowed: true

Markdown

• Format on Save: off
• Use on Type Format: false
• Prettier:
  • Allowed: true

PHP

• Language Servers: phpactor, !intelephense, ...
• Prettier:
  • Allowed: true
  • Plugins: @prettier/plugin-php
  • Parser: php

Ruby

• Language Servers: solargraph, !ruby-lsp, !rubocop, ...

SCSS

• Prettier:
  • Allowed: true

SQL

• Prettier:
  • Allowed: true
  • Plugins: prettier-plugin-sql

Starlark

• Language Servers: starpls, !buck2-lsp, ...

Svelte

• Language Servers: svelte-language-server, ...
• Prettier:
  • Allowed: true
  • Plugins: prettier-plugin-svelte

TSX

• Language Servers: !typescript-language-server, vtsls, ...
• Prettier:
  • Allowed: true

Twig

• Prettier:
  • Allowed: true

TypeScript

• Language Servers: !typescript-language-server, vtsls, ...
• Prettier:
  • Allowed: true

Vue.js

• Language Servers: vue-language-server, ...
• Prettier:
  • Allowed: true

XML

• Prettier:
  • Allowed: true
  • Plugins: @prettier/plugin-xml

YAML

• Prettier:
  • Allowed: true

Language Model Settings

Anthropic

• Version: 1
• API URL: https://api.anthropic.com

Google

• API URL: https://generativelanguage.googleapis.com

Ollama

• API URL: http://localhost:11434

OpenAI

• Version: 1
• API URL: https://api.openai.com/v1

Prettier Integration Settings

• Prettier:
  • Allows to enable/disable formatting with Prettier.
  • Use default Prettier when no project-level Prettier installation is found.

LSP Settings

• LSP:
  • Configuration for Language Server Protocol (LSP) integration.

Jupyter Settings

• Enabled: true
• Kernel Selections:
  • Configure language-specific kernels (e.g., "python": "conda-base", "typescript": "deno").

Vim Settings

• Toggle Relative Line Numbers: false
• Use System Clipboard: always
• Use Multiline Find: false
• Use Smartcase Find: false
• Custom Digraphs: {}

Server Settings

• Server URL: https://zed.dev

Zed Preview Settings

• Overrides settings for Zed Preview, mostly useful for developers managing multiple instances of Zed.

Zed Nightly Settings

• Overrides settings for Zed Nightly, mostly useful for developers managing multiple instances of Zed.

Zed Stable Settings

• Overrides settings for Zed Stable, mostly useful for developers managing multiple instances of Zed.

Zed Dev Settings

• Overrides settings for Zed Dev, mostly useful for developers managing multiple instances of Zed.

Task Settings

• Show Task Status Indicator: true

Line Indicator Format

• Line Indicator Format: long (Displays full labels like "2 selections, 15 lines, 32 characters")

Proxy Settings

• Proxy: null (No proxy by default, or uses environment variables)

Command Aliases

• Configure aliases for the command palette. Example:
  • "W": "workspace::Save"

SSH Connections

• SSH Connections: [] (No SSH connections configured)

Context Servers

• Context Servers: {}

Full configuration

Zed editor version number: 0.163.3

json
{
  // The name of the Zed theme to use for the UI.
  //
  // `mode` is one of:
  // - "system": Use the theme that corresponds to the system's appearance
  // - "light": Use the theme indicated by the "light" field
  // - "dark": Use the theme indicated by the "dark" field
  "theme": {
    "mode": "system",
    "light": "One Light",
    "dark": "One Dark"
  },
  // The name of a base set of key bindings to use.
  // This setting can take four values, each named after another
  // text editor:
  //
  // 1. "VSCode"
  // 2. "Atom"
  // 3. "JetBrains"
  // 4. "None"
  // 5. "SublimeText"
  // 6. "TextMate"
  "base_keymap": "VSCode",
  // Features that can be globally enabled or disabled
  "features": {
    // Which inline completion provider to use.
    "inline_completion_provider": "copilot"
  },
  // The name of a font to use for rendering text in the editor
  "buffer_font_family": "Zed Plex Mono",
  // Set the buffer text's font fallbacks, this will be merged with
  // the platform's default fallbacks.
  "buffer_font_fallbacks": null,
  // The OpenType features to enable for text in the editor.
  "buffer_font_features": {
    // Disable ligatures:
    // "calt": false
  },
  // The default font size for text in the editor
  "buffer_font_size": 15,
  // The weight of the editor font in standard CSS units from 100 to 900.
  "buffer_font_weight": 400,
  // Set the buffer's line height.
  // May take 3 values:
  //  1. Use a line height that's comfortable for reading (1.618)
  //         "buffer_line_height": "comfortable"
  //  2. Use a standard line height, (1.3)
  //         "buffer_line_height": "standard",
  //  3. Use a custom line height
  //         "buffer_line_height": {
  //           "custom": 2
  //         },
  "buffer_line_height": "comfortable",
  // The name of a font to use for rendering text in the UI
  // You can set this to ".SystemUIFont" to use the system font
  "ui_font_family": "Zed Plex Sans",
  // Set the UI's font fallbacks, this will be merged with the platform's
  // default font fallbacks.
  "ui_font_fallbacks": null,
  // The OpenType features to enable for text in the UI
  "ui_font_features": {
    // Disable ligatures:
    "calt": false
  },
  // The weight of the UI font in standard CSS units from 100 to 900.
  "ui_font_weight": 400,
  // The default font size for text in the UI
  "ui_font_size": 16,
  // How much to fade out unused code.
  "unnecessary_code_fade": 0.3,
  // Active pane styling settings.
  "active_pane_modifiers": {
    // The factor to grow the active pane by. Defaults to 1.0
    // which gives the same size as all other panes.
    "magnification": 1.0,
    // Inset border size of the active pane, in pixels.
    "border_size": 0.0,
    // Opacity of the inactive panes. 0 means transparent, 1 means opaque.
    // Values are clamped to the [0.0, 1.0] range.
    "inactive_opacity": 1.0
  },
  // The direction that you want to split panes horizontally. Defaults to "up"
  "pane_split_direction_horizontal": "up",
  // The direction that you want to split panes horizontally. Defaults to "left"
  "pane_split_direction_vertical": "left",
  // Centered layout related settings.
  "centered_layout": {
    // The relative width of the left padding of the central pane from the
    // workspace when the centered layout is used.
    "left_padding": 0.2,
    // The relative width of the right padding of the central pane from the
    // workspace when the centered layout is used.
    "right_padding": 0.2
  },
  // The key to use for adding multiple cursors
  // Currently "alt" or "cmd_or_ctrl"  (also aliased as
  // "cmd" and "ctrl") are supported.
  "multi_cursor_modifier": "alt",
  // Whether to enable vim modes and key bindings.
  "vim_mode": false,
  // Whether to show the informational hover box when moving the mouse
  // over symbols in the editor.
  "hover_popover_enabled": true,
  // Whether to confirm before quitting Zed.
  "confirm_quit": false,
  // Whether to restore last closed project when fresh Zed instance is opened.
  "restore_on_startup": "last_session",
  // Size of the drop target in the editor.
  "drop_target_size": 0.2,
  // Whether the window should be closed when using 'close active item' on a window with no tabs.
  // May take 3 values:
  //  1. Use the current platform's convention
  //         "when_closing_with_no_tabs": "platform_default"
  //  2. Always close the window:
  //         "when_closing_with_no_tabs": "close_window",
  //  3. Never close the window
  //         "when_closing_with_no_tabs": "keep_window_open",
  "when_closing_with_no_tabs": "platform_default",
  // Whether to use the system provided dialogs for Open and Save As.
  // When set to false, Zed will use the built-in keyboard-first pickers.
  "use_system_path_prompts": true,
  // Whether the cursor blinks in the editor.
  "cursor_blink": true,
  // Cursor shape for the default editor.
  //  1. A vertical bar
  //     "bar"
  //  2. A block that surrounds the following character
  //     "block"
  //  3. An underline / underscore that runs along the following character
  //     "underline"
  //  4. A box drawn around the following character
  //     "hollow"
  //
  // Default: not set, defaults to "bar"
  "cursor_shape": null,
  // How to highlight the current line in the editor.
  //
  // 1. Don't highlight the current line:
  //    "none"
  // 2. Highlight the gutter area:
  //    "gutter"
  // 3. Highlight the editor area:
  //    "line"
  // 4. Highlight the full line (default):
  //    "all"
  "current_line_highlight": "all",
  // Whether to pop the completions menu while typing in an editor without
  // explicitly requesting it.
  "show_completions_on_input": true,
  // Whether to display inline and alongside documentation for items in the
  // completions menu
  "show_completion_documentation": true,
  // The debounce delay before re-querying the language server for completion
  // documentation when not included in original completion list.
  "completion_documentation_secondary_query_debounce": 300,
  // Show method signatures in the editor, when inside parentheses.
  "auto_signature_help": false,
  /// Whether to show the signature help after completion or a bracket pair inserted.
  /// If `auto_signature_help` is enabled, this setting will be treated as enabled also.
  "show_signature_help_after_edits": false,
  // Whether to show wrap guides (vertical rulers) in the editor.
  // Setting this to true will show a guide at the 'preferred_line_length' value
  // if 'soft_wrap' is set to 'preferred_line_length', and will show any
  // additional guides as specified by the 'wrap_guides' setting.
  "show_wrap_guides": true,
  // Character counts at which to show wrap guides in the editor.
  "wrap_guides": [],
  // Hide the values of in variables from visual display in private files
  "redact_private_values": false,
  // The default number of lines to expand excerpts in the multibuffer by.
  "expand_excerpt_lines": 3,
  // Globs to match against file paths to determine if a file is private.
  "private_files": ["**/.env*", "**/*.pem", "**/*.key", "**/*.cert", "**/*.crt", "**/secrets.yml"],
  // Whether to use additional LSP queries to format (and amend) the code after
  // every "trigger" symbol input, defined by LSP server capabilities.
  "use_on_type_format": true,
  // Whether to automatically add matching closing characters when typing
  // opening parenthesis, bracket, brace, single or double quote characters.
  // For example, when you type (, Zed will add a closing ) at the correct position.
  "use_autoclose": true,
  // Whether to automatically surround selected text when typing opening parenthesis,
  // bracket, brace, single or double quote characters.
  // For example, when you select text and type (, Zed will surround the text with ().
  "use_auto_surround": true,
  // Whether indentation of pasted content should be adjusted based on the context.
  "auto_indent_on_paste": true,
  // Controls how the editor handles the autoclosed characters.
  // When set to `false`(default), skipping over and auto-removing of the closing characters
  // happen only for auto-inserted characters.
  // Otherwise(when `true`), the closing characters are always skipped over and auto-removed
  // no matter how they were inserted.
  "always_treat_brackets_as_autoclosed": false,
  // Controls whether inline completions are shown immediately (true)
  // or manually by triggering `editor::ShowInlineCompletion` (false).
  "show_inline_completions": true,
  // Controls whether inline completions are shown in a given language scope.
  // Example: ["string", "comment"]
  "inline_completions_disabled_in": [],
  // Whether to show tabs and spaces in the editor.
  // This setting can take three values:
  //
  // 1. Draw tabs and spaces only for the selected text (default):
  //    "selection"
  // 2. Do not draw any tabs or spaces:
  //    "none"
  // 3. Draw all invisible symbols:
  //    "all"
  // 4. Draw whitespaces at boundaries only:
  //    "boundary"
  // For a whitespace to be on a boundary, any of the following conditions need to be met:
  // - It is a tab
  // - It is adjacent to an edge (start or end)
  // - It is adjacent to a whitespace (left or right)
  "show_whitespaces": "selection",
  // Settings related to calls in Zed
  "calls": {
    // Join calls with the microphone live by default
    "mute_on_join": false,
    // Share your project when you are the first to join a channel
    "share_on_join": false
  },
  // Toolbar related settings
  "toolbar": {
    // Whether to show breadcrumbs.
    "breadcrumbs": true,
    // Whether to show quick action buttons.
    "quick_actions": true,
    // Whether to show the Selections menu in the editor toolbar
    "selections_menu": true
  },
  // Scrollbar related settings
  "scrollbar": {
    // When to show the scrollbar in the editor.
    // This setting can take four values:
    //
    // 1. Show the scrollbar if there's important information or
    //    follow the system's configured behavior (default):
    //   "auto"
    // 2. Match the system's configured behavior:
    //    "system"
    // 3. Always show the scrollbar:
    //    "always"
    // 4. Never show the scrollbar:
    //    "never"
    "show": "auto",
    // Whether to show cursor positions in the scrollbar.
    "cursors": true,
    // Whether to show git diff indicators in the scrollbar.
    "git_diff": true,
    // Whether to show buffer search results in the scrollbar.
    "search_results": true,
    // Whether to show selected symbol occurrences in the scrollbar.
    "selected_symbol": true,
    // Whether to show diagnostic indicators in the scrollbar.
    "diagnostics": true
  },
  // Enable middle-click paste on Linux.
  "middle_click_paste": true,
  // What to do when multibuffer is double clicked in some of its excerpts
  // (parts of singleton buffers).
  // May take 2 values:
  //  1. Behave as a regular buffer and select the whole word (default).
  //         "double_click_in_multibuffer": "select"
  //  2. Open the excerpt clicked as a new buffer in the new tab.
  //         "double_click_in_multibuffer": "open",
  // For the case of "open", regular selection behavior can be achieved by holding `alt` when double clicking.
  "double_click_in_multibuffer": "select",
  "gutter": {
    // Whether to show line numbers in the gutter.
    "line_numbers": true,
    // Whether to show code action buttons in the gutter.
    "code_actions": true,
    // Whether to show runnables buttons in the gutter.
    "runnables": true,
    // Whether to show fold buttons in the gutter.
    "folds": true
  },
  "indent_guides": {
    /// Whether to show indent guides in the editor.
    "enabled": true,
    /// The width of the indent guides in pixels, between 1 and 10.
    "line_width": 1,
    /// The width of the active indent guide in pixels, between 1 and 10.
    "active_line_width": 1,
    /// Determines how indent guides are colored.
    /// This setting can take the following three values:
    ///
    /// 1. "disabled"
    /// 2. "fixed"
    /// 3. "indent_aware"
    "coloring": "fixed",
    /// Determines how indent guide backgrounds are colored.
    /// This setting can take the following two values:
    ///
    /// 1. "disabled"
    /// 2. "indent_aware"
    "background_coloring": "disabled"
  },
  // Whether the editor will scroll beyond the last line.
  "scroll_beyond_last_line": "one_page",
  // The number of lines to keep above/below the cursor when scrolling.
  "vertical_scroll_margin": 3,
  // Scroll sensitivity multiplier. This multiplier is applied
  // to both the horizontal and vertical delta values while scrolling.
  "scroll_sensitivity": 1.0,
  "relative_line_numbers": false,
  // If 'search_wrap' is disabled, search result do not wrap around the end of the file.
  "search_wrap": true,
  // Search options to enable by default when opening new project and buffer searches.
  "search": {
    "whole_word": false,
    "case_sensitive": false,
    "include_ignored": false,
    "regex": false
  },
  // When to populate a new search's query based on the text under the cursor.
  // This setting can take the following three values:
  //
  // 1. Always populate the search query with the word under the cursor (default).
  //    "always"
  // 2. Only populate the search query when there is text selected
  //    "selection"
  // 3. Never populate the search query
  //    "never"
  "seed_search_query_from_cursor": "always",
  "use_smartcase_search": false,
  // Inlay hint related settings
  "inlay_hints": {
    // Global switch to toggle hints on and off, switched off by default.
    "enabled": false,
    // Toggle certain types of hints on and off, all switched on by default.
    "show_type_hints": true,
    "show_parameter_hints": true,
    // Corresponds to null/None LSP hint type value.
    "show_other_hints": true,
    // Whether to show a background for inlay hints.
    //
    // If set to `true`, the background will use the `hint.background` color from the current theme.
    "show_background": false,
    // Time to wait after editing the buffer, before requesting the hints,
    // set to 0 to disable debouncing.
    "edit_debounce_ms": 700,
    // Time to wait after scrolling the buffer, before requesting the hints,
    // set to 0 to disable debouncing.
    "scroll_debounce_ms": 50
  },
  "project_panel": {
    // Whether to show the project panel button in the status bar
    "button": true,
    // Default width of the project panel.
    "default_width": 240,
    // Where to dock the project panel. Can be 'left' or 'right'.
    "dock": "left",
    // Whether to show file icons in the project panel.
    "file_icons": true,
    // Whether to show folder icons or chevrons for directories in the project panel.
    "folder_icons": true,
    // Whether to show the git status in the project panel.
    "git_status": true,
    // Amount of indentation for nested items.
    "indent_size": 20,
    // Whether to reveal it in the project panel automatically,
    // when a corresponding project entry becomes active.
    // Gitignored entries are never auto revealed.
    "auto_reveal_entries": true,
    // Whether to fold directories automatically and show compact folders
    // (e.g. "a/b/c" ) when a directory has only one subdirectory inside.
    "auto_fold_dirs": true,
    /// Scrollbar-related settings
    "scrollbar": {
      /// When to show the scrollbar in the project panel.
      /// This setting can take four values:
      ///
      /// 1. null (default): Inherit editor settings
      /// 2. Show the scrollbar if there's important information or
      ///    follow the system's configured behavior (default):
      ///   "auto"
      /// 3. Match the system's configured behavior:
      ///    "system"
      /// 4. Always show the scrollbar:
      ///    "always"
      /// 5. Never show the scrollbar:
      ///    "never"
      "show": null
    },
    /// Which files containing diagnostic errors/warnings to mark in the project panel.
    /// This setting can take the following three values:
    ///
    /// 1. Do not mark any files:
    ///    "off"
    /// 2. Only mark files with errors:
    ///    "errors"
    /// 3. Mark files with errors and warnings:
    ///    "all"
    "show_diagnostics": "all",
    // Settings related to indent guides in the project panel.
    "indent_guides": {
      // When to show indent guides in the project panel.
      // This setting can take two values:
      //
      // 1. Always show indent guides:
      //    "always"
      // 2. Never show indent guides:
      //    "never"
      "show": "always"
    }
  },
  "outline_panel": {
    // Whether to show the outline panel button in the status bar
    "button": true,
    // Default width of the outline panel.
    "default_width": 300,
    // Where to dock the outline panel. Can be 'left' or 'right'.
    "dock": "left",
    // Whether to show file icons in the outline panel.
    "file_icons": true,
    // Whether to show folder icons or chevrons for directories in the outline panel.
    "folder_icons": true,
    // Whether to show the git status in the outline panel.
    "git_status": true,
    // Amount of indentation for nested items.
    "indent_size": 20,
    // Whether to reveal it in the outline panel automatically,
    // when a corresponding outline entry becomes active.
    // Gitignored entries are never auto revealed.
    "auto_reveal_entries": true,
    /// Whether to fold directories automatically
    /// when a directory has only one directory inside.
    "auto_fold_dirs": true,
    // Settings related to indent guides in the outline panel.
    "indent_guides": {
      // When to show indent guides in the outline panel.
      // This setting can take two values:
      //
      // 1. Always show indent guides:
      //    "always"
      // 2. Never show indent guides:
      //    "never"
      "show": "always"
    },
    /// Scrollbar-related settings
    "scrollbar": {
      /// When to show the scrollbar in the project panel.
      /// This setting can take four values:
      ///
      /// 1. null (default): Inherit editor settings
      /// 2. Show the scrollbar if there's important information or
      ///    follow the system's configured behavior (default):
      ///   "auto"
      /// 3. Match the system's configured behavior:
      ///    "system"
      /// 4. Always show the scrollbar:
      ///    "always"
      /// 5. Never show the scrollbar:
      ///    "never"
      "show": null
    }
  },
  "collaboration_panel": {
    // Whether to show the collaboration panel button in the status bar.
    "button": true,
    // Where to dock the collaboration panel. Can be 'left' or 'right'.
    "dock": "left",
    // Default width of the collaboration panel.
    "default_width": 240
  },
  "chat_panel": {
    // Whether to show the chat panel button in the status bar.
    "button": true,
    // Where to the chat panel. Can be 'left' or 'right'.
    "dock": "right",
    // Default width of the chat panel.
    "default_width": 240
  },
  "message_editor": {
    // Whether to automatically replace emoji shortcodes with emoji characters.
    // For example: typing `:wave:` gets replaced with `👋`.
    "auto_replace_emoji_shortcode": true
  },
  "notification_panel": {
    // Whether to show the notification panel button in the status bar.
    "button": true,
    // Where to dock the notification panel. Can be 'left' or 'right'.
    "dock": "right",
    // Default width of the notification panel.
    "default_width": 380
  },
  "assistant": {
    // Version of this setting.
    "version": "2",
    // Whether the assistant is enabled.
    "enabled": true,
    // Whether to show inline hints showing the keybindings to use the inline assistant and the
    // assistant panel.
    "show_hints": true,
    // Whether to show the assistant panel button in the status bar.
    "button": true,
    // Where to dock the assistant panel. Can be 'left', 'right' or 'bottom'.
    "dock": "right",
    // Default width when the assistant is docked to the left or right.
    "default_width": 640,
    // Default height when the assistant is docked to the bottom.
    "default_height": 320,
    // The default model to use when creating new chats.
    "default_model": {
      // The provider to use.
      "provider": "zed.dev",
      // The model to use.
      "model": "claude-3-5-sonnet"
    }
  },
  // The settings for slash commands.
  "slash_commands": {
    // Settings for the `/docs` slash command.
    "docs": {
      // Whether `/docs` is enabled.
      "enabled": false
    },
    // Settings for the `/project` slash command.
    "project": {
      // Whether `/project` is enabled.
      "enabled": false
    }
  },
  // Whether the screen sharing icon is shown in the os status bar.
  "show_call_status_icon": true,
  // Whether to use language servers to provide code intelligence.
  "enable_language_server": true,
  // Whether to perform linked edits of associated ranges, if the language server supports it.
  // For example, when editing opening <html> tag, the contents of the closing </html> tag will be edited as well.
  "linked_edits": true,
  // The list of language servers to use (or disable) for all languages.
  //
  // This is typically customized on a per-language basis.
  "language_servers": ["..."],
  // When to automatically save edited buffers. This setting can
  // take four values.
  //
  // 1. Never automatically save:
  //     "autosave": "off",
  // 2. Save when changing focus away from the Zed window:
  //     "autosave": "on_window_change",
  // 3. Save when changing focus away from a specific buffer:
  //     "autosave": "on_focus_change",
  // 4. Save when idle for a certain amount of time:
  //     "autosave": { "after_delay": {"milliseconds": 500} },
  "autosave": "off",
  // Settings related to the editor's tab bar.
  "tab_bar": {
    // Whether or not to show the tab bar in the editor
    "show": true,
    // Whether or not to show the navigation history buttons.
    "show_nav_history_buttons": true
  },
  // Settings related to the editor's tabs
  "tabs": {
    // Show git status colors in the editor tabs.
    "git_status": false,
    // Position of the close button on the editor tabs.
    "close_position": "right",
    // Whether to show the file icon for a tab.
    "file_icons": false,
    // What to do after closing the current tab.
    //
    // 1. Activate the tab that was open previously (default)
    //     "History"
    // 2. Activate the neighbour tab (prefers the right one, if present)
    //     "Neighbour"
    "activate_on_close": "history"
  },
  // Settings related to preview tabs.
  "preview_tabs": {
    // Whether preview tabs should be enabled.
    // Preview tabs allow you to open files in preview mode, where they close automatically
    // when you switch to another file unless you explicitly pin them.
    // This is useful for quickly viewing files without cluttering your workspace.
    "enabled": true,
    // Whether to open tabs in preview mode when selected from the file finder.
    "enable_preview_from_file_finder": false,
    // Whether a preview tab gets replaced when code navigation is used to navigate away from the tab.
    "enable_preview_from_code_navigation": false
  },
  // Settings related to the file finder.
  "file_finder": {
    // Whether to show file icons in the file finder.
    "file_icons": true,
    // Determines how much space the file finder can take up in relation to the available window width.
    // There are 5 possible width values:
    //
    // 1. Small: This value is essentially a fixed width.
    //    "modal_width": "small"
    // 2. Medium:
    //    "modal_width": "medium"
    // 3. Large:
    //    "modal_width": "large"
    // 4. Extra Large:
    //    "modal_width": "xlarge"
    // 5. Fullscreen: This value removes any horizontal padding, as it consumes the whole viewport width.
    //    "modal_width": "full"
    //
    // Default: small
    "modal_max_width": "small"
  },
  // Whether or not to remove any trailing whitespace from lines of a buffer
  // before saving it.
  "remove_trailing_whitespace_on_save": true,
  // Whether to start a new line with a comment when a previous line is a comment as well.
  "extend_comment_on_newline": true,
  // Whether or not to ensure there's a single newline at the end of a buffer
  // when saving it.
  "ensure_final_newline_on_save": true,
  // Whether or not to perform a buffer format before saving
  //
  // Keep in mind, if the autosave with delay is enabled, format_on_save will be ignored
  "format_on_save": "on",
  // How to perform a buffer format. This setting can take 4 values:
  //
  // 1. Format code using the current language server:
  //     "formatter": "language_server"
  // 2. Format code using an external command:
  //     "formatter": {
  //       "external": {
  //         "command": "prettier",
  //         "arguments": ["--stdin-filepath", "{buffer_path}"]
  //       }
  //     }
  // 3. Format code using Zed's Prettier integration:
  //     "formatter": "prettier"
  // 4. Default. Format files using Zed's Prettier integration (if applicable),
  //    or falling back to formatting via language server:
  //     "formatter": "auto"
  "formatter": "auto",
  // How to soft-wrap long lines of text.
  // Possible values:
  //
  // 1. Prefer a single line generally, unless an overly long line is encountered.
  //      "soft_wrap": "none",
  //      "soft_wrap": "prefer_line", // (deprecated, same as "none")
  // 2. Soft wrap lines that overflow the editor.
  //      "soft_wrap": "editor_width",
  // 3. Soft wrap lines at the preferred line length.
  //      "soft_wrap": "preferred_line_length",
  // 4. Soft wrap lines at the preferred line length or the editor width (whichever is smaller).
  //      "soft_wrap": "bounded",
  "soft_wrap": "none",
  // The column at which to soft-wrap lines, for buffers where soft-wrap
  // is enabled.
  "preferred_line_length": 80,
  // Whether to indent lines using tab characters, as opposed to multiple
  // spaces.
  "hard_tabs": false,
  // How many columns a tab should occupy.
  "tab_size": 4,
  // Control what info is collected by Zed.
  "telemetry": {
    // Send debug info like crash reports.
    "diagnostics": true,
    // Send anonymized usage data like what languages you're using Zed with.
    "metrics": true
  },
  // Automatically update Zed. This setting may be ignored on Linux if
  // installed through a package manager.
  "auto_update": true,
  // Diagnostics configuration.
  "diagnostics": {
    // Whether to show warnings or not by default.
    "include_warnings": true
  },
  // Add files or globs of files that will be excluded by Zed entirely:
  // they will be skipped during FS scan(s), file tree and file search
  // will lack the corresponding file entries.
  "file_scan_exclusions": [
    "**/.git",
    "**/.svn",
    "**/.hg",
    "**/CVS",
    "**/.DS_Store",
    "**/Thumbs.db",
    "**/.classpath",
    "**/.settings"
  ],
  // Git gutter behavior configuration.
  "git": {
    // Control whether the git gutter is shown. May take 2 values:
    // 1. Show the gutter
    //      "git_gutter": "tracked_files"
    // 2. Hide the gutter
    //      "git_gutter": "hide"
    "git_gutter": "tracked_files",
    // Control whether the git blame information is shown inline,
    // in the currently focused line.
    "inline_blame": {
      "enabled": true
      // Sets a delay after which the inline blame information is shown.
      // Delay is restarted with every cursor movement.
      // "delay_ms": 600
      //
      // Whether or not do display the git commit summary on the same line.
      // "show_commit_summary": false
      //
      // The minimum column number to show the inline blame information at
      // "min_column": 0
    }
  },
  // Configuration for how direnv configuration should be loaded. May take 2 values:
  // 1. Load direnv configuration using `direnv export json` directly.
  //      "load_direnv": "direct"
  // 2. Load direnv configuration through the shell hook, works for POSIX shells and fish.
  //      "load_direnv": "shell_hook"
  "load_direnv": "direct",
  "inline_completions": {
    // A list of globs representing files that inline completions should be disabled for.
    "disabled_globs": [".env"]
  },
  // Settings specific to journaling
  "journal": {
    // The path of the directory where journal entries are stored
    "path": "~",
    // What format to display the hours in
    // May take 2 values:
    // 1. hour12
    // 2. hour24
    "hour_format": "hour12"
  },
  // Settings specific to the terminal
  "terminal": {
    // What shell to use when opening a terminal. May take 3 values:
    // 1. Use the system's default terminal configuration in /etc/passwd
    //      "shell": "system"
    // 2. A program:
    //      "shell": {
    //        "program": "sh"
    //      }
    // 3. A program with arguments:
    //     "shell": {
    //         "with_arguments": {
    //           "program": "/bin/bash",
    //           "args": ["--login"]
    //         }
    //     }
    "shell": "system",
    // Where to dock terminals panel. Can be `left`, `right`, `bottom`.
    "dock": "bottom",
    // Default width when the terminal is docked to the left or right.
    "default_width": 640,
    // Default height when the terminal is docked to the bottom.
    "default_height": 320,
    // What working directory to use when launching the terminal.
    // May take 4 values:
    // 1. Use the current file's project directory.  Will Fallback to the
    //    first project directory strategy if unsuccessful
    //      "working_directory": "current_project_directory"
    // 2. Use the first project in this workspace's directory
    //      "working_directory": "first_project_directory"
    // 3. Always use this platform's home directory (if we can find it)
    //     "working_directory": "always_home"
    // 4. Always use a specific directory. This value will be shell expanded.
    //    If this path is not a valid directory the terminal will default to
    //    this platform's home directory  (if we can find it)
    //      "working_directory": {
    //        "always": {
    //          "directory": "~/zed/projects/"
    //        }
    //      }
    "working_directory": "current_project_directory",
    // Set the cursor blinking behavior in the terminal.
    // May take 3 values:
    //  1. Never blink the cursor, ignoring the terminal mode
    //         "blinking": "off",
    //  2. Default the cursor blink to off, but allow the terminal to
    //     set blinking
    //         "blinking": "terminal_controlled",
    //  3. Always blink the cursor, ignoring the terminal mode
    //         "blinking": "on",
    "blinking": "terminal_controlled",
    // Default cursor shape for the terminal.
    //  1. A block that surrounds the following character
    //     "block"
    //  2. A vertical bar
    //     "bar"
    //  3. An underline / underscore that runs along the following character
    //     "underline"
    //  4. A box drawn around the following character
    //     "hollow"
    //
    // Default: not set, defaults to "block"
    "cursor_shape": null,
    // Set whether Alternate Scroll mode (code: ?1007) is active by default.
    // Alternate Scroll mode converts mouse scroll events into up / down key
    // presses when in the alternate screen (e.g. when running applications
    // like vim or  less). The terminal can still set and unset this mode.
    // May take 2 values:
    //  1. Default alternate scroll mode to on
    //         "alternate_scroll": "on",
    //  2. Default alternate scroll mode to off
    //         "alternate_scroll": "off",
    "alternate_scroll": "off",
    // Set whether the option key behaves as the meta key.
    // May take 2 values:
    //  1. Rely on default platform handling of option key, on macOS
    //     this means generating certain unicode characters
    //         "option_as_meta": false,
    //  2. Make the option keys behave as a 'meta' key, e.g. for emacs
    //         "option_as_meta": true,
    "option_as_meta": false,
    // Whether or not selecting text in the terminal will automatically
    // copy to the system clipboard.
    "copy_on_select": false,
    // Whether to show the terminal button in the status bar
    "button": true,
    // Any key-value pairs added to this list will be added to the terminal's
    // environment. Use `:` to separate multiple values.
    "env": {
      // "KEY": "value1:value2"
    },
    // Set the terminal's line height.
    // May take 3 values:
    //  1. Use a line height that's comfortable for reading, 1.618
    //         "line_height": "comfortable"
    //  2. Use a standard line height, 1.3. This option is useful for TUIs,
    //      particularly if they use box characters
    //         "line_height": "standard",
    //  3. Use a custom line height.
    //         "line_height": {
    //           "custom": 2
    //         },
    "line_height": "comfortable",
    // Activate the python virtual environment, if one is found, in the
    // terminal's working directory (as resolved by the working_directory
    // setting). Set this to "off" to disable this behavior.
    "detect_venv": {
      "on": {
        // Default directories to search for virtual environments, relative
        // to the current working directory. We recommend overriding this
        // in your project's settings, rather than globally.
        "directories": [".env", "env", ".venv", "venv"],
        // Can also be `csh`, `fish`, `nushell` and `power_shell`
        "activate_script": "default"
      }
    },
    "toolbar": {
      // Whether to display the terminal title in its toolbar.
      "title": true
    }
    // Set the terminal's font size. If this option is not included,
    // the terminal will default to matching the buffer's font size.
    // "font_size": 15,
    // Set the terminal's font family. If this option is not included,
    // the terminal will default to matching the buffer's font family.
    // "font_family": "Zed Plex Mono",
    // Set the terminal's font fallbacks. If this option is not included,
    // the terminal will default to matching the buffer's font fallbacks.
    // This will be merged with the platform's default font fallbacks
    // "font_fallbacks": ["FiraCode Nerd Fonts"],
    // Sets the maximum number of lines in the terminal's scrollback buffer.
    // Default: 10_000, maximum: 100_000 (all bigger values set will be treated as 100_000), 0 disables the scrolling.
    // Existing terminals will not pick up this change until they are recreated.
    // "max_scroll_history_lines": 10000,
  },
  "code_actions_on_format": {},
  /// Settings related to running tasks.
  "tasks": {
    "variables": {}
  },
  // An object whose keys are language names, and whose values
  // are arrays of filenames or extensions of files that should
  // use those languages.
  //
  // For example, to treat files like `foo.notjs` as JavaScript,
  // and `Embargo.lock` as TOML:
  //
  // {
  //   "JavaScript": ["notjs"],
  //   "TOML": ["Embargo.lock"]
  // }
  //
  "file_types": {
    "Plain Text": ["txt"],
    "JSONC": ["**/.zed/**/*.json", "**/zed/**/*.json", "**/Zed/**/*.json"],
    "Shell Script": [".env.*"]
  },
  /// By default use a recent system version of node, or install our own.
  /// You can override this to use a version of node that is not in $PATH with:
  /// {
  ///   "node": {
  ///     "path": "/path/to/node"
  ///     "npm_path": "/path/to/npm" (defaults to node_path/../npm)
  ///   }
  /// }
  /// or to ensure Zed always downloads and installs an isolated version of node:
  /// {
  ///   "node": {
  ///     "ignore_system_version": true,
  ///   }
  /// NOTE: changing this setting currently requires restarting Zed.
  "node": {},
  // The extensions that Zed should automatically install on startup.
  //
  // If you don't want any of these extensions, add this field to your settings
  // and change the value to `false`.
  "auto_install_extensions": {
    "html": true
  },
  // Different settings for specific languages.
  "languages": {
    "Astro": {
      "language_servers": ["astro-language-server", "..."],
      "prettier": {
        "allowed": true,
        "plugins": ["prettier-plugin-astro"]
      }
    },
    "Blade": {
      "prettier": {
        "allowed": true
      }
    },
    "C": {
      "format_on_save": "off",
      "use_on_type_format": false
    },
    "C++": {
      "format_on_save": "off",
      "use_on_type_format": false
    },
    "CSS": {
      "prettier": {
        "allowed": true
      }
    },
    "Dart": {
      "tab_size": 2
    },
    "Diff": {
      "remove_trailing_whitespace_on_save": false,
      "ensure_final_newline_on_save": false
    },
    "Elixir": {
      "language_servers": ["elixir-ls", "!next-ls", "!lexical", "..."]
    },
    "Erlang": {
      "language_servers": ["erlang-ls", "!elp", "..."]
    },
    "Go": {
      "code_actions_on_format": {
        "source.organizeImports": true
      }
    },
    "GraphQL": {
      "prettier": {
        "allowed": true
      }
    },
    "HEEX": {
      "language_servers": ["elixir-ls", "!next-ls", "!lexical", "..."]
    },
    "HTML": {
      "prettier": {
        "allowed": true
      }
    },
    "Java": {
      "prettier": {
        "allowed": true,
        "plugins": ["prettier-plugin-java"]
      }
    },
    "JavaScript": {
      "language_servers": ["!typescript-language-server", "vtsls", "..."],
      "prettier": {
        "allowed": true
      }
    },
    "JSON": {
      "prettier": {
        "allowed": true
      }
    },
    "JSONC": {
      "prettier": {
        "allowed": true
      }
    },
    "Markdown": {
      "format_on_save": "off",
      "use_on_type_format": false,
      "prettier": {
        "allowed": true
      }
    },
    "PHP": {
      "language_servers": ["phpactor", "!intelephense", "..."],
      "prettier": {
        "allowed": true,
        "plugins": ["@prettier/plugin-php"],
        "parser": "php"
      }
    },
    "Ruby": {
      "language_servers": ["solargraph", "!ruby-lsp", "!rubocop", "..."]
    },
    "SCSS": {
      "prettier": {
        "allowed": true
      }
    },
    "SQL": {
      "prettier": {
        "allowed": true,
        "plugins": ["prettier-plugin-sql"]
      }
    },
    "Starlark": {
      "language_servers": ["starpls", "!buck2-lsp", "..."]
    },
    "Svelte": {
      "language_servers": ["svelte-language-server", "..."],
      "prettier": {
        "allowed": true,
        "plugins": ["prettier-plugin-svelte"]
      }
    },
    "TSX": {
      "language_servers": ["!typescript-language-server", "vtsls", "..."],
      "prettier": {
        "allowed": true
      }
    },
    "Twig": {
      "prettier": {
        "allowed": true
      }
    },
    "TypeScript": {
      "language_servers": ["!typescript-language-server", "vtsls", "..."],
      "prettier": {
        "allowed": true
      }
    },
    "Vue.js": {
      "language_servers": ["vue-language-server", "..."],
      "prettier": {
        "allowed": true
      }
    },
    "XML": {
      "prettier": {
        "allowed": true,
        "plugins": ["@prettier/plugin-xml"]
      }
    },
    "YAML": {
      "prettier": {
        "allowed": true
      }
    }
  },
  // Different settings for specific language models.
  "language_models": {
    "anthropic": {
      "version": "1",
      "api_url": "https://api.anthropic.com"
    },
    "google": {
      "api_url": "https://generativelanguage.googleapis.com"
    },
    "ollama": {
      "api_url": "http://localhost:11434"
    },
    "openai": {
      "version": "1",
      "api_url": "https://api.openai.com/v1"
    }
  },
  // Zed's Prettier integration settings.
  // Allows to enable/disable formatting with Prettier
  // and configure default Prettier, used when no project-level Prettier installation is found.
  "prettier": {
    // // Whether to consider prettier formatter or not when attempting to format a file.
    // "allowed": false,
    //
    // // Use regular Prettier json configuration.
    // // If Prettier is allowed, Zed will use this for its Prettier instance for any applicable file, if
    // // the project has no other Prettier installed.
    // "plugins": [],
    //
    // // Use regular Prettier json configuration.
    // // If Prettier is allowed, Zed will use this for its Prettier instance for any applicable file, if
    // // the project has no other Prettier installed.
    // "trailingComma": "es5",
    // "tabWidth": 4,
    // "semi": false,
    // "singleQuote": true
  },
  // LSP Specific settings.
  "lsp": {
    // Specify the LSP name as a key here.
    // "rust-analyzer": {
    //     // These initialization options are merged into Zed's defaults
    //     "initialization_options": {
    //         "check": {
    //             "command": "clippy" // rust-analyzer.check.command (default: "check")
    //         }
    //     }
    // }
  },
  // Jupyter settings
  "jupyter": {
    "enabled": true
    // Specify the language name as the key and the kernel name as the value.
    // "kernel_selections": {
    //    "python": "conda-base"
    //    "typescript": "deno"
    // }
  },
  // Vim settings
  "vim": {
    "toggle_relative_line_numbers": false,
    "use_system_clipboard": "always",
    "use_multiline_find": false,
    "use_smartcase_find": false,
    "custom_digraphs": {}
  },
  // The server to connect to. If the environment variable
  // ZED_SERVER_URL is set, it will override this setting.
  "server_url": "https://zed.dev",
  // Settings overrides to use when using Zed Preview.
  // Mostly useful for developers who are managing multiple instances of Zed.
  "preview": {
    // "theme": "Andromeda"
  },
  // Settings overrides to use when using Zed Nightly.
  // Mostly useful for developers who are managing multiple instances of Zed.
  "nightly": {
    // "theme": "Andromeda"
  },
  // Settings overrides to use when using Zed Stable.
  // Mostly useful for developers who are managing multiple instances of Zed.
  "stable": {
    // "theme": "Andromeda"
  },
  // Settings overrides to use when using Zed Dev.
  // Mostly useful for developers who are managing multiple instances of Zed.
  "dev": {
    // "theme": "Andromeda"
  },
  // Task-related settings.
  "task": {
    // Whether to show task status indicator in the status bar. Default: true
    "show_status_indicator": true
  },
  // Whether to show full labels in line indicator or short ones
  //
  // Values:
  //   - `short`: "2 s, 15 l, 32 c"
  //   - `long`: "2 selections, 15 lines, 32 characters"
  // Default: long
  "line_indicator_format": "long",
  // Set a proxy to use. The proxy protocol is specified by the URI scheme.
  //
  // Supported URI scheme: `http`, `https`, `socks4`, `socks4a`, `socks5`,
  // `socks5h`. `http` will be used when no scheme is specified.
  //
  // By default no proxy will be used, or Zed will try get proxy settings from
  // environment variables.
  //
  // Examples:
  //   - "proxy": "socks5h://localhost:10808"
  //   - "proxy": "http://127.0.0.1:10809"
  "proxy": null,
  // Set to configure aliases for the command palette.
  // When typing a query which is a key of this object, the value will be used instead.
  //
  // Examples:
  // {
  //   "W": "workspace::Save"
  // }
  "command_aliases": {},
  // ssh_connections is an array of ssh connections.
  // You can configure these from `project: Open Remote` in the command palette.
  // Zed's ssh support will pull configuration from your ~/.ssh too.
  // Examples:
  // [
  //   {
  //     "host": "example-box",
  //     // "port": 22, "username": "test", "args": ["-i", "/home/user/.ssh/id_rsa"]
  //     "projects": [
  //       {
  //         "paths": ["/home/user/code/zed"]
  //       }
  //     ]
  //   }
  // ]
  "ssh_connections": [],
  // Configures context servers for use in the Assistant.
  "context_servers": {}
}

Reference Article

Zed Official Documentation