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

# CLI Overview

> Manage MCP servers from the terminal with Harbor's command-line interface.

The Harbor CLI gives you full control over your MCP server fleet from the terminal. Every command uses a nautical theme, with standard aliases available if you prefer.

## Installation

<Tabs>
  <Tab title="macOS / Linux">
    ```sh theme={null}
    curl -fsSL https://harbormcp.ai/install.sh | sh
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    irm https://harbormcp.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

On **macOS**, the install script installs the desktop app (which includes the CLI) and symlinks `harbor` to your PATH. Use `HARBOR_NO_APP=1` for a CLI-only install.

On **Linux**, it installs the `harbor` CLI binary directly.

On **Windows**, the PowerShell script downloads and runs the MSI installer silently.

You can also build from source:

```sh theme={null}
git clone https://github.com/JoshuaShunk/Harbor.git
cd Harbor
cargo install --path crates/harbor-cli
```

## Usage

```sh theme={null}
harbor <command> [options]
```

Run `harbor --help` to see all available commands, or `harbor <command> --help` for details on a specific command.

## Quick Example

```sh theme={null}
# Dock a native server (one command, built-in auth)
harbor dock github

# Or dock a custom server manually
harbor dock --name memory --command npx --args "-y,@modelcontextprotocol/server-memory"

# Link a host
harbor port link claude

# Check your fleet
harbor fleet

# Start the gateway
harbor lighthouse
```

## Nautical Naming

Harbor uses a nautical theme for its commands. Every command has a standard alias if you prefer conventional names:

| Nautical     | Standard    | What it does                    |
| ------------ | ----------- | ------------------------------- |
| `dock`       | `add`       | Add a server (native or custom) |
| `undock`     | `remove`    | Remove a server                 |
| `fleet`      | `list`      | List servers                    |
| `launch`     | `start`     | Start a server                  |
| `manifest`   | `status`    | Show status                     |
| `signal`     | `sync`      | Sync to hosts                   |
| `port`       | `host`      | Manage host connections         |
| `lighthouse` | `gateway`   | Start the HTTP gateway          |
| `cargo`      | `filter`    | Manage tool filters             |
| `scout`      | `search`    | Search the MCP Registry         |
| `chest`      | `vault`     | Manage secrets                  |
| `scuttle`    | `uninstall` | Uninstall Harbor                |
| `update`     | —           | Update to latest version        |

See the [full command reference](/cli/commands) for all commands.