8000 GitHub - ARCANGEL0/Ghost: Ghost is a free and open source agentic coding tool, with multiple providers + free gateway. · GitHub
[go: up one dir, main page]

Skip to content
8000
ARCANGEL0Public

About

Ghost is a free and open source agentic coding tool, with multiple providers + free gateway.

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

 
 

Repository files navigation

Ghost CLI Logo


👻 A lightning-fast, beautiful AI assistant that lives in your terminal — powered by free models.

Go Release License: MIT Go Version


Ghost terminal screenshots

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.


✨ Why Ghost?

  • 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.

🧠 Models out of the box

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.


🚀 Getting Started

The fast way (macOS & Linux)

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

Manual download (Windows, macOS, Linux)

  1. Go to the Releases page.
  2. Download the archive for your system (.tar.gz for macOS/Linux, .zip for Windows).
  3. Extract it and move the ghost binary somewhere on your PATH.

Build from source

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/

💻 Usage

Start an interactive chat session:

ghost

Run 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 do

🛠️ Configuration

Ghost 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.


🙏 Acknowledgments

  • 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.

📄 License

Ghost is open-source software licensed under the MIT License. Fork it, mod it, make it your own.


📸 Screenshots

Ghost code assistance  Ghost theme selector  Ghost commands  Ghost interface

About

Ghost is a free and open source agentic coding tool, with multiple providers + free gateway.

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0