Ghost CLI

AI coding assistant with honest token tracking. Unlike other CLIs that show their own approximation, Ghost queries the real balance after every turn, so you see exactly what's deducted.

Features

• 🧠 Streaming responses from Claude Opus, Sonnet, Haiku
• 🛠 Built-in tools: read, write, edit, bash, grep, glob, ls
• 💰 Real-time token deduction display — no surprises on the bill
• 🛡 Permission gates for destructive ops (write/edit/bash) — bypass with --yolo
• 🎨 Markdown rendering, syntax highlighting, colored diffs
• ⚡ Slash commands: /help, /balance, /model, /tools, /clear, /exit
• 🪟 Cross-platform: Windows (PowerShell) + Unix (bash)

Install

npm install -g ghost-cli

Or run from source:

git clone <repo>
cd cli
npm install
npm run build
npm link

Setup

On first run, paste your API key (from https://keys.dedik888.fun):

ghost

The key is saved to ~/.ghost/config.json (chmod 600).

Usage

ghost                                  # interactive REPL
ghost --model claude-sonnet-4.6        # pick a model
ghost --yolo                           # auto-approve all tool calls

In a session:

▶ Refactor src/utils.ts to use async/await
▶ /balance
▶ /model claude-opus-4.7
▶ /exit

Available models

• claude-opus-4.8, claude-opus-4.7, claude-opus-4.6
• claude-sonnet-4.6, claude-sonnet-4.5
• claude-haiku-4.5

Why "honest"?

Other AI CLIs estimate tokens client-side and don't account for cache tokens or per-model multipliers. Ghost CLI queries the real billing endpoint after every assistant turn and shows you the actual deducted amount + remaining balance.

License

MIT