> ## Documentation Index
> Fetch the complete documentation index at: https://www.jetify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Zed Editor

> [Zed](https://zed.dev/) is a fast, open source code editor designed for collaboration and AI support, that is available for macOS and Linux. Zed has support for loading environments directly from Direnv's `.envrc` files, meaning you can easily use Zed w/ Devbox via our [direnv integration](/devbox/ide_configuration/direnv).

## Setting up your Project for Zed[​](#setting-up-your-project-for-zed "Direct link to Setting up your Project for Zed")

1. Make sure that you have direnv installed on your host. To use direnv across all your projects, we
   recommend installing it with [devbox global](/docs/devbox/devbox-global/) using
   `devbox global add direnv`. You can also follow
   [this guide](https://direnv.net/#basic-installation) to configure direnv for your system

2. Generate a `.envrc` file for your project by running `devbox generate direnv` in your project's
   root directory (the same directory with your `devbox.json` file.

3. You can now open your project in Zed and it will automatically load your Devbox shell environment
   variables from the `.envrc` file.

## Troubleshooting your Zed Setup[​](#troubleshooting-your-zed-setup "Direct link to Troubleshooting your Zed Setup")

If you are having trouble getting Zed's LSP to detect your Devbox environment, try the following
steps:

1. Make sure you are up to date with the latest version of Zed. You can check for updates by going
   to `Zed > Check for Updates` in the Zed menu.

2. You may need to explicitly tell your LSP to use the binaries in your \$PATH variable. To do this,
   add the following to the `~/.config/zed/config.json` file:

```json theme={null}
{
  ...
  "lsp": {
    "<lsp-name>": {
      "binary": {"path_lookup": true}
    }
  },
  ...
}
```

3. If you have a version of the binary/language server installed on your host machine, Zed's default
   behavior for loading direnv directly may cause conflicts with the packages installed via Devbox.
   To fix this, add the following to your `~/.config/zed/config.json` file:

```json theme={null}
{
  "load_direnv": "shell_hook"
}
```

[Edit this page](https://github.com/jetify-com/docs/tree/main/docs/devbox/ide-configuration/zed/index.mdx)