TokenSaver
EN

La documentation est disponible en anglais.

Documentation / 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)