OS Manuals

/usr/bin/zed

Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.

From zed 1.24.4-r2 (os), captured 2026-11-05 by running zed --help (exit 0). permalink

Also provided by 1 other package version
The Zed CLI binary.
This CLI is a separate binary that invokes Zed.

Examples:
    `zed`
          Simply opens Zed
    `zed --foreground`
          Runs in foreground (shows all logs)
    `zed path-to-your-project`
          Open your project in Zed
    `zed -n path-to-file `
          Open file/folder in a new window


Usage: zed [OPTIONS] [PATHS_WITH_POSITION]...

Arguments:
  [PATHS_WITH_POSITION]...
          The paths to open in Zed (space-separated).

          Use `path:line:column` syntax to open a file at the given line and column.

Options:
  -w, --wait
          Wait for all of the given paths to be opened/closed before exiting.

          When opening a directory, waits until the created window is closed.

  -a, --add
          Add files to the currently open workspace

  -n, --new
          Create a new workspace

  -e, --existing
          Open in existing Zed window

      --user-data-dir <DIR>
          Sets a custom directory for all user data (e.g., database, extensions, logs). This
          overrides the default platform-specific data directory location: `$XDG_DATA_HOME/zed`

  -v, --version
          Print Zed's version and the app path

      --foreground
          Run zed in the foreground (useful for debugging)

      --zed <ZED>
          Custom path to Zed.app or the zed binary

      --dev-server-token <DEV_SERVER_TOKEN>
          Run zed in dev-server mode

      --system-specs
          Not supported in Zed CLI, only supported on Zed binary Will attempt to give the correct
          command to run

      --dev-container
          Open the project in a dev container.

          Automatically triggers "Reopen in Dev Container" if a `.devcontainer/` configuration is
          found in the project directory.

      --diff <OLD_PATH> <NEW_PATH>
          Pairs of file paths to diff. Can be specified multiple times. When directories are
          provided, recurses into them and shows all changed files in a single multi-diff view

      --completions <SHELL>
          Generate shell completions for Zed

          [possible values: bash, elvish, fish, nushell, powershell, zsh]

      --uninstall
          Uninstall Zed from user system

  -h, --help
          Print help (see a summary with '-h')

To read from stdin, append '-', e.g. 'ps axf | zed -'
Options (14)
OptionDescriptionSource
-w, --waitWait for all of the given paths to be opened/closed before exiting.help
-a, --addAdd files to the currently open workspacehelp
-n, --newCreate a new workspacehelp
-e, --existingOpen in existing Zed windowhelp
--user-data-dir DIRSets a custom directory for all user data (e.g., database, extensions, logs).help
-v, --versionPrint Zed's version and the app pathhelp
--foregroundRun zed in the foreground (useful for debugging)help
--zed ZEDCustom path to Zed.app or the zed binaryhelp
--dev-server-token DEV_SERVER_TOKENRun zed in dev-server modehelp
--system-specsNot supported in Zed CLI, only supported on Zed binary Will attempt to give the correct command to runhelp
--dev-containerOpen the project in a dev container.help
--completions SHELLGenerate shell completions for Zedhelp
--uninstallUninstall Zed from user systemhelp
-h, --helpPrint help (see a summary with '-h')help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.