> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getunblocked.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install, update, and uninstall the CLI

> Get the Unblocked CLI onto your machine, keep it up to date, and remove it cleanly

## Install

There are two install scripts, depending on how much you want set up for you.

<Tabs>
  <Tab title="CLI + MCP + skills">
    ```bash theme={null}
    curl -fsSL https://getunblocked.com/install-mcp.sh | bash
    ```

    Downloads the `unblocked` binary, runs [`unblocked install`](#unblocked-install) to configure every supported IDE and AI coding agent it detects, and installs [skills](/unblocked-mcp/skills). After the script finishes you are prompted to authenticate through the browser.

    Pick this script if you want a one-shot setup that wires Unblocked MCP into your existing tools.
  </Tab>

  <Tab title="CLI only">
    ```bash theme={null}
    curl -fsSL https://getunblocked.com/install.sh | bash
    ```

    Downloads just the `unblocked` binary. It does **not** configure any IDE, install skills, or start the auth flow — you need to run [`unblocked auth`](/unblocked-cli/cli-auth) manually before using any command that hits your workspace.

    Pick this script if you only want the standalone CLI — for example to use the [`context-*` commands](/unblocked-cli/cli-query) in scripts or CI — and do not want Unblocked reaching into your IDE configs.
  </Tab>

  <Tab title="Windows / Linux">
    The Unblocked CLI is not yet available on Windows or Linux — support is coming soon. In the meantime, [contact us](https://getunblocked.com/dashboard?showIntercom=true) via Intercom if you need a hand.

    You can still connect your IDE or agent to Unblocked's **remote** MCP server on these platforms. The per-agent install guides under [Unblocked MCP](/unblocked-mcp/mcp-overview) walk through the remote MCP setup for [Claude Code](/unblocked-mcp/install-claude-code), [Claude Desktop](/unblocked-mcp/install-claude-desktop), [Codex](/unblocked-mcp/install-codex), [Cursor](/unblocked-mcp/install-cursor), [Windsurf](/unblocked-mcp/install-windsurf), and [other clients](/unblocked-mcp/install-other).
  </Tab>
</Tabs>

If `unblocked` is not on your `PATH`, the install scripts place it in `~/.local/bin/` — add that directory to your `PATH` or invoke the binary directly.

Verify the install:

```bash theme={null}
unblocked --version
```

## Configure IDEs and agents

Once the CLI is installed, three commands control what gets wired into your IDEs and AI coding agents.

### `unblocked install`

```bash theme={null}
unblocked install
```

Configures every supported IDE it detects (Claude Code, Claude Desktop, Codex, Cursor, Windsurf, and others) with:

* the Unblocked [MCP server](/unblocked-mcp/mcp-overview), and
* the Unblocked [skills](/unblocked-mcp/skills) that teach agents how to use it.

The `install-mcp.sh` quick install script runs this for you.

### `unblocked install-mcp`

```bash theme={null}
unblocked install-mcp
```

Configures supported IDEs with only the MCP server — skills are not installed. Use this when you manage skills separately (for example, via the Claude Code plugin marketplace or a shared skills repository).

### `unblocked install-skills`

```bash theme={null}
unblocked install-skills
```

Installs or refreshes the Unblocked skills in each detected agent without touching MCP configuration. Skills are stored in a canonical location at `~/.agents/skills/` and symlinked into each agent's own skills directory (for example `~/.claude/skills/`, `~/.cursor/skills/`, `~/.codeium/windsurf/skills/`). Running the CLI again automatically pulls the latest skills; if you have modified a skill locally the CLI stops updating that specific skill so your changes are preserved.

<Note>
  Per-IDE installation instructions — including plugin, manual, and headless/token-based setups — live under [Unblocked MCP](/unblocked-mcp/mcp-overview).
</Note>

## Update

```bash theme={null}
unblocked update
```

Checks for a newer version of the Unblocked CLI and, if one is available, downloads and installs it in place. Run this when:

* You see a notice that a new CLI version is available.
* An MCP call or `context-*` command fails with a message indicating your CLI is out of date.
* You want to pick up the latest [skills](/unblocked-mcp/skills) and tool descriptions. Each CLI run refreshes skills automatically, but upgrading the CLI itself occasionally ships larger improvements.

If `unblocked update` cannot reach the update server — for example from an offline or firewalled environment — reinstall using either of the install scripts above.

## Uninstall

```bash theme={null}
unblocked uninstall
```

Completely removes Unblocked from the local machine:

* Deletes the `unblocked` binary and supporting files.
* Removes the MCP server entry from every IDE and agent the CLI previously configured.
* Removes the Unblocked [skills](/unblocked-mcp/skills) installed under `~/.agents/skills/` and the symlinks pointing into each agent's skills directory.
* Clears the cached authentication token created by [`unblocked auth`](/unblocked-cli/cli-auth).

<Note>
  `unblocked uninstall` does not sign you out of Unblocked anywhere except this machine. Existing sessions in the Unblocked web app, your messaging platforms, and API tokens generated in Unblocked settings remain active.
</Note>

To remove MCP configuration from a single agent only, edit that agent's MCP config file directly rather than running `uninstall`. The per-agent install guides under [Unblocked MCP](/unblocked-mcp/mcp-overview) describe where those files live.