Appearance
Agents and providers
Ghosted runs any agent tool you have installed: Claude Code, Codex, Gemini CLI, OpenCode, Cursor Agent, Qwen Code, GitHub Copilot, Pi, Amp and more. Agents & providers chooses which one "New agent" starts, how each one is started, and which API provider it uses. (New in 1.0.7.)
Your API keys stay yours
- Ghosted never stores, reads out, shows or sends an API key or your Claude login.
- Keys live where they always have: in your environment (your shell profile, a password manager,
direnv, …). - In Ghosted you only write the name of the variable that holds a key, like
OPENROUTER_API_KEY. Settings shows whether that variable is set or not set on the machine running the agents, never its value. - Ghosted refuses a key typed into its config file, and won't pass on any variable from its config whose name looks like a key or token.
- Ghosted makes no calls to any provider.
Start an agent
| Where | What it does |
|---|---|
| New agent (All actions, or the command palette) | starts your default agent beside the pane you're in |
| New agent in a new tab / in a new workspace | the same, in a new tab or a workspace of its own |
| New agent… | a list of the agent tools you can start; click Pane, Tab or Workspace on one |
| Accounts → New Claude | Claude, logged in as that account (unchanged) |
Each one opens a terminal in the folder you're working in and starts the tool there, with the model, arguments and provider you set.
In Settings
Settings → Agents & providers:
| Row | What it does |
|---|---|
| New agent starts | − / + picks the agent "New agent" starts |
| One row per agent tool (e.g. Codex) | on/off: whether it's offered. Below: installed or not, its version, its model |
| … provider (Claude Code, Codex, Gemini CLI, Qwen Code) | − / + picks the provider it uses: its own (the tool's own login or settings), one of your providers, or a common one (OpenRouter, Ollama, …). Below: where it connects and whether its key variable is set |
Only the tools found on this machine (plus any you set up in the config file) get a row. Ghosted looks for them on your PATH and in the usual install folders, and checks again every ten minutes.
The model, extra arguments and environment are set in the config file.
In the config file
In ~/.config/ghosted/config.toml (see Configuration). Every key is optional; without them "New agent" starts Claude Code as before.
toml
[agents]
default = "codex" # what "New agent" starts
[agents.codex]
enabled = true # false: not offered
command = "codex" # the program, if it's not the usual name
args = ["--search"] # extra arguments
model = "gpt-5-codex" # the model, passed the way the tool expects
provider = "openrouter" # one of [providers] below, or a kind
env = { CODEX_HOME = "/home/me/.codex-work" } # extra settings, never keys
[agents.aider] # a tool Ghosted doesn't know
command = "aider"
model = "sonnet"
model_flag = "--model" # how it takes a model
[providers.openrouter]
kind = "openrouter"
key_env = "OPENROUTER_API_KEY" # the variable's name, not the key
model = "openai/gpt-5" # used when the agent names no model
[providers.box]
kind = "ollama" # on this machine; no key
base_url = "http://localhost:11434/v1"Agent ids are the tools' names: claude, codex, gemini, opencode, cursor, qwen, copilot, pi, amp, droid, cline, kimi, kiro, grok, agy, … or any name of your own with a command.
Provider kinds
kind | Key variable (default) | Address (default) |
|---|---|---|
anthropic | ANTHROPIC_API_KEY | the tool's own |
openai | OPENAI_API_KEY | the tool's own |
openrouter | OPENROUTER_API_KEY | OpenRouter |
gemini | GEMINI_API_KEY | the tool's own |
ollama | none | localhost:11434 |
lmstudio | none | localhost:1234 |
openai_compatible | set key_env | set base_url |
anthropic_compatible | set key_env | set base_url |
provider = "openrouter" works without a [providers.openrouter] section: it uses the kind's defaults.
Which tools can use a provider
| Tool | Providers | How Ghosted passes it |
|---|---|---|
| Claude Code | Anthropic, OpenRouter, Ollama, Anthropic-compatible | its address and key variables; for anything but Anthropic your Claude login isn't sent |
| Codex | OpenAI, OpenRouter, Ollama, LM Studio, OpenAI-compatible | a provider on its command line; Codex reads the key from your variable itself |
| Qwen Code | the same as Codex | its OpenAI address and key variables |
| Gemini CLI | Gemini | its key variable |
| Others | none | set the provider up in the tool itself; Ghosted still passes the model and arguments |
When the key is in a variable with another name than the one the tool reads, the new pane's shell copies it across as it starts the tool (env ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY" claude): only the name is in the command, and the shell fills in the value.
The variables are looked up on the machine running the agents. If your key is set in your shell profile but Settings says not set, the Ghosted server was started without it; the agent will still find it, since its pane runs your shell.