plano/demos/integrations/claude_cli

Claude Code CLI as a Plano provider

This demo wires the locally installed claude binary as a Plano model_provider. The single line under model_providers:

model_providers:
  - model: claude-cli/*
    default: true

is enough to:

1. Auto-fill provider_interface: claude-cli, base_url: http://127.0.0.1:14001 and a placeholder access_key (the CLI uses its own login keychain).
2. Start a localhost bridge inside brightstaff that spawns claude -p --output-format stream-json --input-format stream-json for each conversation.
3. Expose every Claude Code model — claude-cli/sonnet, claude-cli/opus, claude-cli/haiku, plus dated full ids — at GET /v1/models.

Running

# Make sure the CLI is logged in. You can use API krey billing or a paid Claude subscription.
claude auth login

# Start Plano in native mode.
planoai up demos/integrations/claude_cli/config.yaml

Then point any OpenAI- or Anthropic-style client at http://localhost:12000 and pick any claude-cli/... model. Plano routes the request through Envoy to the brightstaff bridge, which asks the local claude binary to handle it.

Optional overrides

Set these env vars before planoai up if you need to tweak the bridge:

Env var	Default	Meaning
CLAUDE_CLI_BIN	claude	Path to the CLI binary.
CLAUDE_CLI_PERMISSION_MODE	bypassPermissions	--permission-mode flag value.
CLAUDE_CLI_LISTEN_ADDR	127.0.0.1:14001	Bridge listen address.
CLAUDE_CLI_SESSION_TTL_SECS	600	Idle TTL before a child is killed.
CLAUDE_CLI_WATCHDOG_SECS	120	Per-line watchdog inside one CLI turn.
CLAUDE_CLI_MAX_SESSIONS	64	Hard cap on concurrent CLI children.