tokensaver-cli 0.1.0

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

TokenSaver CLI (tokensaver-cli)

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

Companion package to tokensaver-sdk (Python API client). The CLI configures your local machine; the pipeline runs on TokenSaver servers.

Get started: sign up at platform.tokensaver.fr, create a ts_… API key, then:

pip install tokensaver-cli
export TOKENSAVER_API_KEY=ts_your_key
tokensaver route claude --launch
tokensaver doctor

Installation

pip install tokensaver-cli

Development inside the monorepo:

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

Requirements: Python ≥ 3.10, no extra runtime dependencies (stdlib only).

Commands

Command	Purpose
tokensaver route claude	Configure Claude Code (~/.claude/settings.json + .mcp.json)
tokensaver route claude --launch	Configure + start claude
tokensaver route cursor	Write .cursor/mcp.json + print Override URL steps
tokensaver route codex	Print OpenAI-compat env vars for Codex
tokensaver route proxy	Show base URLs for LangChain / OpenAI SDK / your code
tokensaver unroute <target>	Restore backed-up config
tokensaver doctor	Check API key and SaaS endpoint reachability

SaaS defaults (no local server)

Surface	URL
API	https://api.tokensaver.fr
OpenAI-compat	https://api.tokensaver.fr/openai/v1
Anthropic-compat	https://api.tokensaver.fr/anthropic
MCP tools	https://mcp.tokensaver.fr/mcp
MCP gateway	https://gateway.tokensaver.fr/mcp

Override with TOKENSAVER_API_URL, TOKENSAVER_MCP_URL, etc. if you use a private deployment.

Environment

export TOKENSAVER_API_KEY=ts_…   # required
# optional scope for MCP gateway headers:
export X-Organisation-ID=…
export X-Workspace-ID=…

Related packages

PyPI package	Role
tokensaver-cli	This package — tokensaver route / doctor
tokensaver-sdk	Python API client — TokenSaver(api_key=…).ask(…)

API reference (public): tokensaver.fr/sdk-api

Tests

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

Publishing to PyPI

Maintainers: see docs/PYPI-CLI-RELEASE.md.

Tag format: cli-vX.Y.Z (version in src/tokensaver_cli/__init__.py).