Skip to content
Kurahi

Kurahi models

Model discovery, scanning, and configuration (default model, fallbacks, auth profiles).

Related:

Common commands

Section titled “Common commands”
Terminal window
kurahi models status
kurahi models list
kurahi models set <model-or-alias>
kurahi models scan

kurahi models status shows the resolved default/fallbacks plus an auth overview. When provider usage snapshots are available, the OAuth/token status section includes provider usage headers. Add --probe to run live auth probes against each configured provider profile. Probes are real requests (may consume tokens and trigger rate limits). Use --agent <id> to inspect a configured agent’s model/auth state. When omitted, the command uses KOLO_AGENT_DIR/PI_CODING_AGENT_DIR if set, otherwise the configured default agent.

Notes:

  • models set <model-or-alias> accepts provider/model or an alias.
  • Model refs are parsed by splitting on the first /. If the model ID includes / (OpenRouter-style), include the provider prefix (example: openrouter/moonshotai/kimi-k2).
  • If you omit the provider, Kurahi treats the input as an alias or a model for the default provider (only works when there is no / in the model ID).

models status

Section titled “models status”

Options:

  • --json
  • --plain
  • --check (exit 1=expired/missing, 2=expiring)
  • --probe (live probe of configured auth profiles)
  • --probe-provider <name> (probe one provider)
  • --probe-profile <id> (repeat or comma-separated profile ids)
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>
  • --agent <id> (configured agent id; overrides KOLO_AGENT_DIR/PI_CODING_AGENT_DIR)

Bench and the KODA tested catalogue

Section titled “Bench and the KODA tested catalogue”
Terminal window
kurahi models tested [--residency jp] [--min-score 70] [--tested-only] [--json]
kurahi models bench --model <provider/model> [--quick-model <provider/model>] [--only <ids>] [--max-tokens <n>]
kurahi models bench-merge <bench-report.json...> --out <dir> [--update-catalogue <file>]

models tested prints the shipped catalogue: scores per axis, residency, cost per resident-hour and the date of the last benchmark. models bench runs the resident task suite under a token cap and writes a signed report with evidence bundles. See KODA tested models.

Aliases + fallbacks

Section titled “Aliases + fallbacks”
Terminal window
kurahi models aliases list
kurahi models fallbacks list

Auth profiles

Section titled “Auth profiles”
Terminal window
kurahi models auth add
kurahi models auth login --provider <id>
kurahi models auth setup-token
kurahi models auth paste-token

models auth login runs a provider plugin’s auth flow (OAuth/API key). Use kurahi plugins list to see which providers are installed.

Notes:

  • setup-token prompts for a setup-token value (generate it with claude setup-token on any machine).
  • paste-token accepts a token string generated elsewhere or from automation.