The Unblocked CLI is actively evolving. Command names, flags, and output shapes may change over time.
The Unblocked CLI (unblocked) is the single binary that powers the Unblocked MCP server, installs skills into your AI coding agents, and exposes Unblocked’s organizational context through standalone commands you can run yourself or wire into scripts and CI.
Getting started
- Install the CLI — pick one of the two install scripts or the per-agent manual install.
- Authenticate with
unblocked auth, or set an API token for headless environments.
- Query your workspace with the
context-* commands, or let your IDE talk to the MCP server automatically.
MCP and IDE setup
The CLI is how MCP gets installed and run, but if you just want to wire an IDE up to Unblocked MCP, the Unblocked MCP section is the best starting point. It covers per-agent install flows (Claude Code, Claude Desktop, Codex, Cursor, Windsurf, and others), the available MCP tools, and skills.
Command summary
| Command | What it does |
|---|
unblocked install | Configure IDEs with the MCP server and install skills |
unblocked install-mcp | Configure IDEs with the MCP server only |
unblocked install-skills | Install skills into AI coding agents |
unblocked update | Check for and apply available CLI updates |
unblocked uninstall | Remove the CLI, MCP configs, skills, and auth tokens |
unblocked auth | Run the browser-based authentication flow |
unblocked mcp | Run the MCP server (JSON-RPC over stdio) |
unblocked context-research | Research a topic across code, PRs, docs, and other sources |
unblocked context-search-code | Search for context scoped to code |
unblocked context-search-documentation | Search for context scoped to documentation |
unblocked context-search-issues | Search for context scoped to issues |
unblocked context-search-messages | Search for context scoped to messaging |
unblocked context-search-prs | Search for context scoped to pull requests |
unblocked context-query-issues | Retrieve issues using structured filters |
unblocked context-query-prs | Retrieve pull requests using structured filters |
unblocked context-get-urls | Retrieve content from one or more URLs directly |
Global options
| Option | Description |
|---|
--version | Display the CLI version and build number |
--help | Show the top-level command list |