CLI

The OpenCode CLI provides command-line access to OpenCode functionality. By default, running opencode starts the terminal user interface (TUI).

opencode

Pass commands for programmatic interaction:

opencode run "Explain how closures work in JavaScript"

TUI Flags

Execute OpenCode in non-interactive mode:

opencode run [message..]

Flags:

Manage credentials:

opencode auth login    # Configure API keys
opencode auth list     # Display providers
opencode auth logout   # Remove credentials

List available models:

opencode models [provider]
opencode models --refresh  # Update cached list
opencode models --verbose  # Show costs

Manage sessions:

opencode session list
opencode session list --format json

Start headless HTTP server:

opencode serve --port 4096

Start server with web interface:

opencode web --port 4096

Manage agents:

opencode agent create  # Create custom agent
opencode agent list    # List agents

Manage MCP servers:

opencode mcp add       # Add server
opencode mcp list      # Show servers
opencode mcp auth      # Authenticate
opencode mcp debug     # Troubleshoot

Display usage statistics:

opencode stats --days 30
opencode stats --models

Update OpenCode:

opencode upgrade           # Latest version
opencode upgrade v0.1.48   # Specific version

Flag	Short	Purpose
`--help`	`-h`	Display help
`--version`	`-v`	Print version
`--print-logs`	—	Output logs to stderr
`--log-level`	—	Set level (DEBUG, INFO, WARN, ERROR)

Variable	Purpose
`OPENCODE_DISABLE_AUTOUPDATE`	Disable updates
`OPENCODE_ENABLE_EXPERIMENTAL_MODELS`	Enable experimental models
`OPENCODE_DISABLE_AUTOCOMPACT`	Disable compaction