Give your agent a route in two minutes.

Install the skill once. The agent discovers local tools, registers this installation, and asks TokenSize for a safe target before it delegates.

1. Install the skill#

Install the public skill into a compatible agent environment. It discovers local harnesses and calls the hosted router without copying your repository into the prompt.

shell
npx skills add tokensize/skills

In Codex, the skill is easy to remember: $delegate.

2. Choose your authentication path#

Agent registration is now available in the capped beta. It uses an Ed25519 installation identity and returns a finite, routing-only credential. Human Clerk login remains available when an owner should manage the installation.

shell
# Agent registration (recommended)
npx @tokensize/cli@beta auth register

# Or use a human-owned Clerk key via the browser callback
npx @tokensize/cli@beta auth login

# Verify the local credential without printing the secret
npx @tokensize/cli@beta auth status

# Native credential lifecycle
npx @tokensize/cli@beta auth rotate
npx @tokensize/cli@beta auth revoke
Registration is explicit; discovery never creates an account Credentials stay in ~/.tokensize Never pass keys as command arguments

3. Discover and inspect#

Discovery probes installed Codex, Claude Code, Cursor, OpenCode and Copilot surfaces. Allowance checks normalize status without invoking a model.

shell
npx @tokensize/cli@beta doctor --json
npx @tokensize/cli@beta allowance --refresh --json

Optional: reuse local experience#

TokenSize can normalize your local Codex and Claude Code history with Letta Trajectory. Profiles and redacted previews stay on your machine; only bounded accounting reaches the hosted router. Nothing is captured until you opt in.

shell
npx @tokensize/cli@beta experience enable --capsules preview
npx @tokensize/cli@beta experience scan
npx @tokensize/cli@beta experience preview --task "Inspect the authentication boundary"

# After reviewing the preview:
npx @tokensize/cli@beta route --task "Inspect the authentication boundary" --experience preview

Verified right/wrong feedback can improve local routing history. Automatic capsules and background consolidation are not enabled.

4. Preview, then execute#

Preview is the control point. Read the target, reason codes and permission before asking TokenSize to execute the route locally.

shell
npx @tokensize/cli@beta route \
  --task "Inspect the authentication boundary" \
  --role inspect --permission inspect --json

npx @tokensize/cli@beta delegate \
  --task "Inspect the authentication boundary" \
  --role inspect --permission inspect --execute --json

Start with inspect. Editing, testing and network access require an explicit permission ceiling and remain subject to local policy.