Zed Extension

⚠️Warning

Zed may send goto type definition requests on each key press while editing TOML files. To avoid unwanted lsp edit tabs, set the following in your tombi.toml:

[lsp]
goto-type-definition.enabled = false

For context, see #1556.

Language Server Binary Priority

The tombi Zed extension selects the Language Server binary in the following order of priority:

Order	Source Type	Description
1	editor settings	Path explicitly specified by `lsp.tombi.binary.path` in Zed settings
2	venv	`tombi` binary found in a Python virtual environment (`.venv/bin/tombi` or `.venv/Scripts/tombi.exe`) in the workspace
3	node_modules	`tombi` binary found in the `node_modules/.bin` directory in the workspace
4	local	`tombi` binary found in the system PATH (via `which tombi`)
5	cached	`tombi` binary cached in the current Zed process from a previous extension-managed resolution
6	downloaded	Download the latest `tombi` binary from GitHub
7	fallback	If the download fails, use the newest already-downloaded extension-managed `tombi` binary

When the extension needs to manage the binary itself for the first time in a given Zed process, step 5 is skipped because no process-local cache exists yet. In that case, the extension attempts step 6 first and only falls back to step 7 if the download fails.

Configuration

You can configure the extension through Zed's LSP settings. For example, to specify custom arguments and environment variables:

{
  "lsp": {
    "tombi": {
      "binary": {
        "arguments": ["lsp", "-v"],
        "env": { "NO_COLOR": "true" }
      }
    }
  }
}

Format settings

If you cannot format your TOML files, please try to set the following settings.

{
  "lsp": {
    "tombi": {
      "binary": {
        "arguments": ["lsp", "-vv"],
        "env": { "NO_COLOR": "true" }
      }
    }
  }
}

Offline Mode

You can set offline mode in the Zed settings file.

{
  "lsp": {
    "tombi": {
      "binary": {
        "arguments": ["lsp", "--offline"]
      }
    }
  }
}

VSCode Extension Configuration