---

name: configuring-zed description: Provides guidance for configuring and customizing the Zed editor. Use when modifying Zed settings, keybindings, themes, or extensions.

Configuring Zed

Configuration Paths

Rules

• Modify global config (~/.config/zed/) unless project-specific override is requested
• Zed uses JSONC (JSON with comments) for config files
• Settings are merged: project settings override global settings

Tips & Hidden Gems

See hidden-gems.md for lesser-known features and productivity tips.

Common Tasks

Adding a keybinding

Copy// ~/.config/zed/keymap.json
[
  {
    "context": "Editor",
    "bindings": {
      "cmd-shift-l": "editor::SelectAllMatches"
    }
  }
]

Configuring language settings

Copy// ~/.config/zed/settings.json
{
  "languages": {
    "TypeScript": {
      "tab_size": 2,
      "formatter": "language_server"
    }
  }
}