CLI reference

CLI overview

The tokenolo command-line interface at a glance.

tokenolo is a command-line tool. You run it to launch your coding agent behind a local proxy: it optimizes each message, your agent runs lean, and nothing about your workflow changes.

Note: the CLI is pre-release and moving fast. Command names and flags below map the current surface — run tokenolo --help to confirm against your installed version.

Command shape

Commands follow a tokenolo <command> shape:

Command	What it does
`tokenolo login --key tk_live_…`	Authenticate the CLI against your account.
`tokenolo wrap <target>`	Launch an agent (`claude` or `codex`) with tokenolo optimizing every message in flight — the core command.
`tokenolo paraphrase [prompt]`	Rewrite a single prompt to use fewer tokens (reads stdin if no argument).
`tokenolo whoami`	Show the authenticated user and remaining daily quota.
`tokenolo stats`	Show cumulative filler tokens trimmed from your local history.
`tokenolo proxy`	Run the local optimizing proxy directly (advanced — `wrap` launches this for you).
`tokenolo logout`	Remove the stored credential.
`tokenolo --version` · `tokenolo --help`	Print the version, or list every command and its flags.

Run tokenolo --help for the full list, or tokenolo <command> --help for a command's own flags.

The core command

Almost everything routes through one command:

tokenolo wrap claude

It launches your agent behind a local proxy and removes redundant filler from each of your messages — removal-only, everything else forwarded untouched. See tokenolo wrap for options and examples.

Where to go next

tokenolo wrap — the full reference for the core command.
Configuration — authenticate the CLI.
Quickstart — install and wrap your first session.
Integrations — drop-in setup for Claude Code and Codex.