Docs / CLI deep dive

CLI — Introduction

The tokensaver console command (PyPI: tokensaver-cli) routes AI agents through the TokenSaver control plane — Anthropic/OpenAI-compatible APIs, MCP tools & Trust Gateway, Agent Registry, and Flux IA observability — without hand-editing env files.

Install

pip install -U tokensaver-cli
tokensaver --help

Requires Python ≥ 3.10. No runtime dependencies. Documented for CLI ≥ 0.3.7.

60-second path (Claude Code)

tokensaver login
tokensaver route claude --launch
tokensaver doctor --claude
tokensaver flows --open

login creates a Free account (or signs in) and writes ~/.config/tokensaver/credentials.json (JWT + API key ts_…). route claude sets ANTHROPIC_BASE_URL, MCP servers, statusline/hooks, and installs the Claude plugin slash commands. See Claude Code use cases.

What the CLI configures

Surface	CLI target
Claude Code	`route claude` → Anthropic API + MCP + plugin
Cursor	`route cursor` → `.cursor/mcp.json` + Override URL steps
Codex / OpenAI clients	`route codex` / `route proxy`
MCP Trust Gateway (stdio)	`route mcp --target "…"`

Credentials & env

File: ~/.config/tokensaver/credentials.json (mode 0600)
TOKENSAVER_API_KEY overrides the file when set
Self-host: tokensaver … --local or TOKENSAVER_MODE=local (API :8000, MCP :8787, gateway :8788, console :3000)