> ## 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. The CLI opens a browser when one is available or prints a manual login URL on headless Linux.

    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="Platform support">
    The install scripts support macOS and glibc-based Linux on x64 and arm64. This includes common distributions such as Debian, Ubuntu, Fedora, and their derivatives.

    Alpine and other musl-based distributions, 32-bit Linux, and Windows are not currently supported. Windows users can still connect an IDE or agent to Unblocked's [remote MCP server](/unblocked-mcp/mcp-overview).
  </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
```

### Install on a headless server

For CI, containers, remote shells, and other environments without a browser, install the CLI without starting authentication:

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

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

Then configure a personal or team API token using the [headless authentication guide](/unblocked-cli/cli-auth#headless-authentication). The MCP installer also skips authentication automatically when it has no controlling terminal.

## 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 on macOS, Codex, Cursor, OpenCode, 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.