Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getunbound.ai/llms.txt

Use this file to discover all available pages before exploring further.

The unbound setup command configures AI coding tools to route through Unbound. It handles authentication, environment variables, and tool-specific config files automatically. If you are not logged in and --api-key is not provided, the browser opens automatically to authenticate before setup begins.

​
Interactive setup

Run with no arguments to select tools from an interactive menu: 
unbound setup

​
Default bundle

Install Cursor, Claude Code (hooks), and Codex (hooks) in one command: 
unbound setup --all

​
Individual tools

​
Cursor

unbound setup cursor

​
Claude Code

Claude Code supports two modes: 
unbound setup claude-code --gateway        # Unbound as the AI provider — no Anthropic subscription needed
unbound setup claude-code --subscription   # Hooks only — keep your existing Anthropic subscription
Run without a flag for interactive mode selection.

​
Gemini CLI

unbound setup gemini-cli

​
Codex

unbound setup codex --gateway              # Unbound as the AI provider — no OpenAI subscription needed
unbound setup codex --subscription         # Hooks only — keep your existing OpenAI subscription

​
Instruction-only tools

These tools require manual configuration. The CLI prints the API key and base URL to enter in each tool’s settings.
ToolCommand
Roo Codeunbound setup roo-code
Clineunbound setup cline
Kilo Codeunbound setup kilo-code
Direct API accessunbound setup custom-access

​
One-step login + setup

Combine authentication and setup in a single command with --api-key: 
# Single tool:
unbound setup cursor --api-key <key>

# Multiple tools (use explicit mode names when combining):
unbound setup cursor claude-code-gateway --api-key <key>

# Login, then select interactively:
unbound setup --api-key <key>
When specifying multiple tools in one command, use the explicit form names:
Short formExplicit form
claude-code --gatewayclaude-code-gateway
claude-code --subscriptionclaude-code-subscription
codex --gatewaycodex-gateway
codex --subscriptioncodex-subscription

​
Remove configuration

unbound setup cursor --clear
unbound setup claude-code --clear
unbound setup gemini-cli --clear
unbound setup codex --clear

​
One-step onboarding

unbound onboard runs setup --all followed by device discovery in a single command. Useful for new user enrollment: 
unbound onboard --api-key <USER_KEY> --discovery-key <DISCOVERY_KEY>

​
MDM setup (admin, requires root)

For organization admins enrolling devices via MDM, unbound setup mdm configures all users on the device: 
# Install the default bundle for all users:
sudo unbound setup mdm --admin-api-key KEY --all

# Specific tools:
sudo unbound setup mdm --admin-api-key KEY cursor codex-subscription
sudo unbound setup mdm --admin-api-key KEY claude-code-subscription codex-subscription gemini-cli

# Remove MDM config:
sudo unbound setup mdm --admin-api-key KEY --clear cursor
For device-wide onboarding in one step: 
sudo unbound onboard-mdm --admin-api-key <ADMIN_KEY> --discovery-key <DISCOVERY_KEY>
MDM setup requires root and is intended for administrators deploying Unbound across an organization’s device fleet. See MDM Integrations for deployment guides.