CLI reference

Every command and flag.

meted <command> [options]

Command
`init`	Create `meted.config.json`
`dev`	Run the gateway locally
`inspect`	Show what a prompt would be allocated
`eval`	Compare natural and metered generation
`mode`	Show or change the operating mode
`deploy`	Deploy to your own Cloudflare account

Global

Flag
`--help`, `-h`	Help for a command
`--version`, `-v`	Print the version

meted help inspect
meted inspect --help

init

meted init [--yes] [--mode <mode>] [--api-key-env <var>]
           [--base-url <url>] [--force]

dev

meted dev [--port <n>] [--host <addr>] [--mode <mode>] [--quiet]

inspect

meted inspect "<prompt>" [--model <id>] [--mode <mode>] [--system <text>]
                         [--file <path>] [--verbose] [--json]

Computes the allocation locally and prints it.

eval

meted eval [suite.json] [--model <id>] [--mode <mode>] [--limit <n>]
           [--concurrency <n>] [--judge] [--judge-model <id>]
           [--evaluator <path>] [--out <path>] [--verbose] [--json]

Calls your provider twice per prompt.

mode

meted mode [observe|conservative|balanced|aggressive] [--json]

deploy

meted deploy [--dir <path>] [--name <name>] [--dry-run] [--scaffold-only]
             [--skip-secret] [--yes]

Asks before running anything. Without a TTY and without --yes, it exits 1.

Exit codes


`0`	Success
`1`	An error, printed to stderr

Environment

Variable
`METED_MODE`	Override the mode
`METED_HOST`, `METED_PORT`	Override where the gateway listens
`METED_PROVIDER_BASE_URL`	Override the provider
`METED_PROVIDER_API_KEY_ENV`	Which variable holds the provider key
`METED_ENGINE_MODULE`, `METED_ENGINE_WASM`	Choose an engine
`METED_DEBUG`	Print stack traces on errors

Piping

meted inspect "What is a semaphore?" --json | jq '.decision.targetOutputTokens'
cat prompt.txt | meted inspect --file -
meted eval --json --limit 20 | jq '.derived.estimatedNetReduction'
meted eval --json --limit 20 > report.json

Every command that prints a table also accepts --json.