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
Authentication
Login
Sign in via browser:
For CI/CD or headless environments, use an API key:
unbound login --api-key <your-api-key>
unbound login --domain custom.example.com
Verify
This shows your email, organization, and role.
Logout
The CLI can automatically configure AI coding tools to route through Unbound. Each command handles authentication, environment variables, and tool-specific configuration.
| Tool | Command |
|---|
| Cursor | unbound setup cursor |
| Claude Code | unbound setup claude-code |
| Gemini CLI | unbound setup gemini-cli |
| Codex | unbound setup codex |
unbound setup <tool> --clear
If you are not logged in, the CLI will automatically open your browser to authenticate before proceeding with setup.
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
--json for machine-readable output.
