Zed Editor

# Official installer (recommended)
curl -f https://zed.dev/install.sh | sh

# Homebrew
brew install --cask zed

# Install the preview channel
brew install --cask zed@preview

# Official installer
curl -f https://zed.dev/install.sh | sh

# Arch Linux (AUR)
paru -S zed-editor

# Flatpak
flatpak install flathub dev.zed.Zed

# Nix
nix-env -iA nixpkgs.zed-editor

# Open a file or directory
zed .
zed src/main.rs

# Open at a specific line
zed src/main.rs:42

# Wait for files to be closed (useful for git)
zed --wait src/main.rs

# Set as default $EDITOR
export EDITOR="zed --wait"

# Set as git editor
git config --global core.editor "zed --wait"

[
  {
    "context": "Editor",
    "bindings": {
      "ctrl-shift-k": "editor::DeleteLine",
      "alt-shift-f": "editor::Format",
      "ctrl-shift-d": "editor::DuplicateLine"
    }
  },
  {
    "context": "Workspace",
    "bindings": {
      "ctrl-shift-t": "workspace::NewTerminal",
      "ctrl-`": "terminal_panel::ToggleFocus"
    }
  }
]

// In settings.json
{
  "vim_mode": true,
  "vim": {
    "use_system_clipboard": "always",
    "use_smartcase_find": true
  }
}

Cmd + F         Find in buffer
Cmd + H         Find and replace
Cmd + Shift + F Project-wide search
Enter           Next match
Shift + Enter   Previous match
Alt + Enter     Select all matches (creates multi-cursor)

Supports: regex, case-sensitive, whole word, multi-line

{
  // UI
  "theme": "One Dark",
  "ui_font_size": 15,
  "buffer_font_family": "JetBrains Mono",
  "buffer_font_size": 14,
  "buffer_line_height": "comfortable",

  // Editor behavior
  "tab_size": 4,
  "hard_tabs": false,
  "format_on_save": "on",
  "remove_trailing_whitespace_on_save": true,
  "ensure_final_newline_on_save": true,
  "soft_wrap": "editor_width",
  "show_whitespaces": "selection",
  "relative_line_numbers": true,

  // Vim mode
  "vim_mode": true,

  // File settings
  "file_scan_exclusions": [
    "**/.git",
    "**/node_modules",
    "**/target",
    "**/.next"
  ],

  // Minimap
  "minimap": {
    "show": "auto"
  },

  // Inlay hints
  "inlay_hints": {
    "enabled": true,
    "show_type_hints": true,
    "show_parameter_hints": true
  }
}

{
  "languages": {
    "Python": {
      "tab_size": 4,
      "formatter": {
        "external": {
          "command": "black",
          "arguments": ["-"]
        }
      }
    },
    "JavaScript": {
      "tab_size": 2,
      "formatter": "prettier"
    },
    "Rust": {
      "tab_size": 4,
      "format_on_save": "on"
    }
  }
}

// Project-local settings override global settings
{
  "tab_size": 2,
  "hard_tabs": false,
  "lsp": {
    "rust-analyzer": {
      "initialization_options": {
        "checkOnSave": {
          "command": "clippy"
        }
      }
    }
  }
}

{
  "lsp": {
    "rust-analyzer": {
      "initialization_options": {
        "checkOnSave": { "command": "clippy" },
        "cargo": { "allFeatures": true },
        "procMacro": { "enable": true }
      }
    },
    "pyright": {
      "settings": {
        "python": {
          "pythonPath": ".venv/bin/python"
        }
      }
    },
    "typescript-language-server": {
      "initialization_options": {
        "preferences": {
          "importModuleSpecifierPreference": "relative"
        }
      }
    }
  }
}

{
  // Use the language server's formatter
  "formatter": "language_server",

  // Use Prettier (auto-detected)
  "formatter": "prettier",

  // Use an external command
  "formatter": {
    "external": {
      "command": "dprint",
      "arguments": ["fmt", "--stdin", "{buffer_path}"]
    }
  }
}

# Open the extensions panel:
Command Palette → "zed: extensions"

# Or use the keyboard shortcut:
Cmd + Shift + X

# Browse, install, and manage from the Extensions panel
# Extensions install instantly (pre-compiled WASM)

my-extension/
  extension.toml      # Metadata (name, version, type)
  src/
    lib.rs            # Rust source (compiled to WASM)
  languages/
    my-lang/
      config.toml     # Language config (LSP, formatter)
      highlights.scm  # Tree-sitter highlighting queries
      injections.scm  # Language injections (e.g., JS in HTML)
  themes/
    my-theme.json     # Theme definition

{
  "assistant": {
    "default_model": {
      "provider": "anthropic",
      "model": "claude-sonnet-4-20250514"
    },
    "version": "2"
  },

  // Or use OpenAI
  "assistant": {
    "default_model": {
      "provider": "openai",
      "model": "gpt-4o"
    }
  },

  // Or use Ollama for local models
  "assistant": {
    "default_model": {
      "provider": "ollama",
      "model": "llama3.1:70b"
    }
  }
}

{
  "terminal": {
    "shell": "system",
    "font_family": "JetBrains Mono",
    "font_size": 13,
    "line_height": "comfortable",
    "working_directory": "current_project_directory",
    "blinking": "terminal_controlled",
    "env": {
      "TERM": "xterm-256color"
    }
  }
}

[
  {
    "label": "cargo test",
    "command": "cargo test",
    "args": [],
    "env": { "RUST_BACKTRACE": "1" },
    "use_new_terminal": true,
    "reveal": "always"
  },
  {
    "label": "run current file",
    "command": "$SHELL",
    "args": ["-c", "$ZED_FILE"],
    "use_new_terminal": false
  }
]

# 1. Open project search
Cmd + Shift + F

# 2. Enter search term, toggle regex if needed
# 3. Click the replace toggle (arrow icon)
# 4. Enter replacement text

# 5. Replace options:
Replace One    → Replace current match
Replace All    → Replace every match across project

# Regex capture groups work ($1, $2, etc.)

# Open the theme selector:
Cmd + K, Cmd + T
# Or: Command Palette → "theme selector: toggle"

# Preview themes by navigating with arrow keys
# Press Enter to apply, Escape to cancel

# Set in settings.json:
{
  "theme": {
    "mode": "dark",
    "dark": "One Dark",
    "light": "One Light"
  }
}

{
  // Editor font (code)
  "buffer_font_family": "JetBrains Mono",
  "buffer_font_size": 14,
  "buffer_font_weight": 400,
  "buffer_font_features": {
    "calt": true,     // Ligatures
    "ss01": true      // Stylistic set 1
  },
  "buffer_line_height": "comfortable",

  // UI font (menus, panels)
  "ui_font_family": "Inter",
  "ui_font_size": 15
}

LSP not starting?
  # Check the Zed log:
  Command Palette → "zed: open log"
  # Restart the language server:
  Command Palette → "lsp: restart server"

Slow on large repos?
  # Add heavy directories to file_scan_exclusions
  # in settings.json (node_modules, target, etc.)

Keymap conflicts?
  # Check key bindings:
  Command Palette → "zed: open keymap"
  # Later entries override earlier ones

GPU rendering issues on Linux?
  # Verify Vulkan support:
  vulkaninfo | head -20
  # Try with software rendering:
  LIBGL_ALWAYS_SOFTWARE=1 zed