For everyone who loves Claude Code and wishes it remembered their setup. Swap models on a whim, tint your projects so Monday-you remembers what Friday-you was doing, and spin up ten pre-configured terminals in a row — without re-picking anything. Hit Enter twice. Work starts.
A Ghostty launcher for Claude Code. Part of flykit.cc.
Claude Code is a powerful agentic coding engine — but it doesn't have to run on Claude. GhostCode makes it trivial to point it at any OpenAI-compatible endpoint: open-weight models, self-hosted inference, or commercial APIs that speak the Anthropic protocol. Switch providers per-project, and your keys stay in the macOS Keychain — never in a config file, never in an env var you forget to unset.
Built-in providers out of the box:
| Provider | API |
|---|---|
| Claude | subscription (OAuth) — no key needed |
| Anthropic | API key — pay-per-token |
| GLM (Z.ai) | API key — GLM-5.2 and family |
| Kimi (Moonshot) | API key — K3, K2.7 Code, K2.6 |
| Qwen (DashScope) | API key — Qwen3 Coder Plus, Qwen3.6 Plus |
| DeepSeek | API key — Reasoner, Chat |
| MiniMax | API key — M2.7 |
| NVIDIA NIM | API key — Llama, Qwen, Nemotron via local translator proxy |
Add your own in ~/.config/ghostcode/providers.json — any OpenAI-compatible endpoint works.
- Fuzzy project picker — type a few chars, starred favorites pinned on top, auto-tracked recents below
- Per-project tints — press
⇧Cto cycle a color; it follows the project into CC's statusline too - Model, effort, mode, provider — all visible on the Dashboard, saved per-project and globally
- Any LLM as a backend — GLM, Kimi, Qwen, DeepSeek, MiniMax, NVIDIA NIM, self-hosted, or any OpenAI-compatible endpoint; keys in Keychain
- First-run wizard — installs Ghostty if missing, wires Ghostty config, wires the CC statusline. Aborts cleanly if you skip.
claude updateon every launch — always ships you the latest- Work tracker — opt-in per project (
Won the Dashboard): tracks attended time, agent time, and tokens per session, with a spoken idle countdown.ghostcode report --week --csvexports client-ready totals.
- macOS
- Homebrew — brew.sh
Everything else (Ghostty, Claude Code) is installed by the first-run wizard.
git clone https://github.com/flykit-cc/ghostcode.git
npm install -g ./ghostcodeThen open Ghostty. The first-run wizard launches automatically and wires Ghostty to run GhostCode on every new window. On subsequent launches, you go straight to the picker.
ghostcode --versionDetailed status of every dep and config point:
# Included in the npm package
$(npm root -g)/@flykit/ghostcode/scripts/doctor.sh| Location | When | Reversible? |
|---|---|---|
~/.config/ghostcode/ |
Always — state, config, setup marker | rm -rf ~/.config/ghostcode |
| Ghostty config | During setup — appends a command = ghostcode line |
Remove the line manually |
~/.claude/settings.json |
During setup — sets statusLine |
Delete the statusLine key |
macOS Keychain (items under account ghostcode) |
When you store non-OAuth provider API keys | Keychain Access → delete entries |
No telemetry. No network calls beyond claude update, brew, and npm — all gated behind wizard prompts. State is local-only.
npm uninstall -g @flykit/ghostcode
rm -rf ~/.config/ghostcode
# Remove the `command = ghostcode` line from your Ghostty config
# Remove the `statusLine` key from ~/.claude/settings.json if added- Not affiliated with Anthropic (Claude, Claude Code) or Mitchell Hashimoto (Ghostty). Claude, Claude Code, Anthropic, and Ghostty are trademarks of their respective owners. GhostCode is an independent integration built for interoperability.
- Licensed MIT — see LICENSE. Use at your own risk. No warranty.
- Interactive system changes — the setup wizard runs
brew install,npm install -g, and writes to the config files listed above. Reviewscripts/init.shbefore running if that's a concern. - API keys for non-OAuth providers are stored in macOS Keychain under account
ghostcode. Never committed, never logged.
MIT. See LICENSE.