tokensaver-cli 0.3.1

TokenSaver CLI — route AI agents (Claude Code, Cursor, Codex) through the control plane

TokenSaver CLI (tokensaver-cli)

Console command tokensaver to route AI agents through the TokenSaver control plane — cache, compression, PII, MCP gateway, observability.

Companion package to tokensaver-sdk.

Quick start (no dashboard required)

pip install -U tokensaver-cli
tokensaver login                 # signup or sign-in → saves credentials + ts_… key
tokensaver route claude --launch
tokensaver doctor --claude

Credentials live in ~/.config/tokensaver/credentials.json (mode 0600).
TOKENSAVER_API_KEY still overrides the file when set.

Installation

pip install tokensaver-cli

Monorepo:

cd packages/cli
python -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"

Requirements: Python ≥ 3.10, stdlib only.

Auth & keys

Command	Purpose
tokensaver login	Interactive signup/sign-in (Free plan + API key)
tokensaver login --email [e-mail] --signup -y	Non-interactive signup
tokensaver login --key ts_…	Import an existing key (no JWT)
tokensaver logout	Remove local credentials
tokensaver whoami	Email, plan, key prefix, Flux IA link
tokensaver keys list	List API keys
tokensaver keys create --name CLI --use	Create key and set as default
tokensaver keys revoke <id>	Delete a key

Routing

Command	Purpose
tokensaver route claude [--launch]	Configure Claude Code + plugin
tokensaver route claude --scope project --profile cheap --with-fs	Project scope, cheap model, FS gateway
tokensaver route cursor / codex / proxy / mcp	Other agents
tokensaver unroute <target>	Restore backups
tokensaver doctor [--claude] [--local]	Health checks
tokensaver status [--line|--hook]	Route status + Flux IA
tokensaver profiles	cheap / default / strong (plan-aware)

Claude Code options

Flag	Effect
--scope user|project|local	Settings file scope
--model / --profile	Catalogue model or profile
--with-fs	Trust Gateway + filesystem for cwd
--no-plugin	Skip ~/.claude/skills/tokensaver-router
--local	Self-host URL defaults

On Free, default profile uses openrouter/z-ai/glm-4.7-flash (allowlist). Paid keeps Sonnet/Opus. Plan is stored at login (plan_slug); refresh with tokensaver whoami.

Environment

export TOKENSAVER_API_KEY=ts_…   # optional if logged in
export TOKENSAVER_MODE=local     # or --local
export TOKENSAVER_PLAN=free      # optional override for Free defaults
export TOKENSAVER_CONSOLE_URL=…

Docs

• Integration: docs/INTEGRATION-ROUTE-CLI.md
• API reference: tokensaver.fr/sdk-api

Tests

cd packages/cli && pip install -e ".[dev]" && pytest -q

Publishing

See docs/PYPI-CLI-RELEASE.md. Tag: cli-vX.Y.Z.