Skip to content

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 ​

WhereWhat 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 workspacethe 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 ClaudeClaude, 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:

RowWhat 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 ​

kindKey variable (default)Address (default)
anthropicANTHROPIC_API_KEYthe tool's own
openaiOPENAI_API_KEYthe tool's own
openrouterOPENROUTER_API_KEYOpenRouter
geminiGEMINI_API_KEYthe tool's own
ollamanonelocalhost:11434
lmstudiononelocalhost:1234
openai_compatibleset key_envset base_url
anthropic_compatibleset key_envset base_url

provider = "openrouter" works without a [providers.openrouter] section: it uses the kind's defaults.

Which tools can use a provider ​

ToolProvidersHow Ghosted passes it
Claude CodeAnthropic, OpenRouter, Ollama, Anthropic-compatibleits address and key variables; for anything but Anthropic your Claude login isn't sent
CodexOpenAI, OpenRouter, Ollama, LM Studio, OpenAI-compatiblea provider on its command line; Codex reads the key from your variable itself
Qwen Codethe same as Codexits OpenAI address and key variables
Gemini CLIGeminiits key variable
Othersnoneset 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.

Made by Megasupersoft. Free to use; not open source. Built on herdr (Apache-2.0).