Hey there! 👋 Welcome to Ghost — a terminal-based AI assistant built to be fast, beautiful, and free.
Ghost ships pre-configured with generous free AI providers, so you can get world-class answers, code suggestions, and command help without entering a credit card. If you live in the terminal and want instant help without alt-tabbing to a browser, Ghost is for you.
Note on UI: Ghost's interface is built on the foundation of Crush by Charm. Huge thanks to the Charm team for the gorgeous terminal toolkit.
- Free out of the box. Pre-wired to free providers — no subscription, no API key required to get started.
- Cross-platform. A single native Go binary for Linux, macOS, and Windows (amd64 + arm64).
- Beautiful TUI. A responsive, themeable terminal interface (Dracula theme included).
- Connect more gateways. Add a provider key with
ghost login <provider>to use its free quota, free models, or credits.
These providers can be used without entering an API key:
| Provider | Models | Notes |
|---|---|---|
| AUTO:FREE | Remote free routes from Kilo, OI VSCode, and configured OpenRouter | Retries the next route when one fails before responding |
| Kilo Gateway | Current :free models and kilo-auto/free |
Free models allow anonymous requests |
| OI VSCode Server | Current community endpoint model | Community-hosted availability |
| Ollama | Models installed on your machine | Local inference |
| Codex CLI | GPT-6.1 Sol through the Codex app-server | Requires Codex CLI and account sign-in |
| Claude Code | Claude Code tools and models through ACP | Requires Claude Code CLI and an active account |
Import a Claude Code or Codex conversation into a new Ghost session with /import --claude <session-id> or /import --codex <session-id>. /resume accepts the same flags. See session import.
Sign in to Codex with ghost login codex. Ghost uses the installed Codex CLI app-server for account-backed turns and resumes imported Codex threads when you continue with the Codex model.
Run ghost login claude to check the installed Claude Code CLI and its account. Ghost uses the Claude Code ACP adapter for the claude-code provider, while the anthropic provider continues to use API keys. See Claude Code ACP.
Add a key to unlock more:
Use ghost free to see current models from OpenRouter, Kilo, Groq, Cerebras, Google AI, Cloudflare, Cohere, NVIDIA NIM, AMD Radeon Cloud, Aion Labs, Hugging Face, LLM7, OpenTyphoon, and Nous Portal. Add a provider key with ghost login <provider>.
See Free model providers for setup steps, current limits, and data-use terms.
Detects your OS/architecture and installs the latest release to /usr/local/bin:
curl -fsSL https://raw.githubusercontent.com/ARCANGEL0/ghost/main/install.sh | bash- Go to the Releases page.
- Download the archive for your system (
.tar.gzfor macOS/Linux,.zipfor Windows). - Extract it and move the
ghostbinary somewhere on yourPATH.
Requires Go 1.26 or newer:
git clone https://github.com/swadhinbiswas/Ghost.git
cd Ghost
go build -o ghost ./main.go
sudo mv ghost /usr/local/bin/Start an interactive chat session:
ghostRun a one-off prompt without entering the full UI:
ghost run "Write a python script to parse a CSV file"Other handy commands:
ghost free # list free and quota-based model catalogs
ghost models # list available models
ghost login # add credentials for keyed providers
ghost login codex # sign in to Codex with a device code
ghost theme # switch the TUI theme
ghost update-providers # refresh the provider registry
ghost session # manage saved sessions
ghost --help # see everything Ghost can doGhost reads JSON config from standard locations ($XDG_CONFIG_HOME/ghost/ghost.json or ~/.config/ghost/ghost.json). A few useful environment variables:
| Variable | Purpose |
|---|---|
GHOST_DISABLE_PROVIDER_AUTO_UPDATE |
Disable automatic provider/model refresh |
GHOST_DISABLE_DEFAULT_PROVIDERS |
Skip all built-in providers (BYO only) |
CLOUDFLARE_ACCOUNT_ID |
Cloudflare Workers AI account used for model discovery and inference |
Ghost refreshes available live model catalogs at startup and uses its cache when a provider is offline. Run ghost free to browse the latest models available to the configured accounts.
- UI foundation: Crush and the Charm ecosystem (
lipgloss,bubbletea,catwalk). - Free providers: Kilo, the OI VSCode community, and the providers listed in the gateway guide.
Ghost is open-source software licensed under the MIT License. Fork it, mod it, make it your own.