@cmdop/opencode-setup

Configure OpenCode to use CmdOp in one command.

npx @cmdop/opencode-setup

What it does

1. Checks local opencode is installed and supported (≥1.4.0)
2. Lets you pick a curated model (Kimi K2.6, Qwen3 235B, MiniMax M2.7)
3. Chooses activation scope (user or project)
4. Accepts your CmdOp API key (hidden prompt, CMDOP_API_KEY, or --api-key-stdin)
5. Writes config, verifies it, and tells you to run opencode

Quick start

Interactive

npx @cmdop/opencode-setup

Non-interactive (CI/scripts)

# via env
CMDOP_API_KEY=gp-... npx @cmdop/opencode-setup --scope project --yes

# via stdin
printf '%s' "$CMDOP_API_KEY" | npx @cmdop/opencode-setup --api-key-stdin --scope project --yes --json

Safe secret inputs

• Hidden interactive prompt
• CMDOP_API_KEY environment variable
• --api-key-stdin flag

Plain --api-key is intentionally unsupported.

Where things go

| File | Purpose | |------|---------| | ~/.cmdop/opencode/api-key | API key (owner-only permissions, never committed) | | ~/.config/opencode/opencode.json | User-scoped provider definition | | ./opencode.json | Project-scoped activation (model + provider) | | ~/.cmdop/opencode/install-state.json | Install metadata for reruns/updates |

Provider contract

• Provider id: cmdop
• Base URL: https://router.cmdop.com/v1
• Transport: chat_completions
• Adapter: @ai-sdk/openai-compatible

Requirements

• Node ≥22.14.0
• opencode CLI on PATH
• CmdOp API key (from cmdop.com)

License

Apache-2.0