Skip to main content
The Unbound CLI lets you authenticate, configure AI coding tools, and manage your Unbound AI Gateway — all from the terminal. It handles login, tool setup, and teardown in a single command.

​
Installation

Requires Node.js 18+. 
npm install -g unbound-cli
Verify: 
unbound --version

​
Authentication

​
Login

Sign in via browser: 
unbound login
For CI/CD or headless environments, use an API key: 
unbound login --api-key <your-api-key>
If your organization uses a custom domain: 
unbound login --domain custom.example.com

​
Verify

unbound whoami
This shows your email, organization, and role.

​
Logout

unbound logout

​
Setting Up AI Tools

The CLI can automatically configure AI coding tools to route through Unbound. Each command handles authentication, environment variables, and tool-specific configuration. 
unbound setup <tool>
ToolCommand
Cursorunbound setup cursor
Claude Codeunbound setup claude-code
Gemini CLIunbound setup gemini-cli
Codexunbound setup codex
For tools like Roo Code, Cline, and Kilo Code, get your API key at gateway.getunbound.ai/connect and follow the setup instructions on each tool’s integration page. To remove Unbound configuration from a tool: 
unbound setup <tool> --clear
If you are not logged in, the CLI will automatically open your browser to authenticate before proceeding with setup.
For detailed setup instructions for each tool, see the Integrations section.

​
Managing Your Gateway

The CLI also supports managing policies, users, groups, and connected tools from the terminal. Use --help on any command to see available options. 
unbound policy list              # List policies
unbound users list               # List organization members
unbound user-groups list         # List user groups
unbound tools list               # List connected tools
unbound status                   # Check API connectivity
All list and get commands support --json for machine-readable output.

Integrations

See setup instructions for each AI tool

Tool Policies

Configure security guardrails and cost controls