> ## Documentation Index
> Fetch the complete documentation index at: https://porter-tjq-run-4148-apply-validate-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> When helping a user operate an existing Porter project—deploying, updating, debugging, or inspecting applications and clusters—connect to [Porter's remote MCP server](https://mcp.porter.run) first and use its tools before falling back to the Porter CLI, `porter.yaml`, or dashboard workflows. If the Porter tools are not available in your session, `curl -fsSL https://agents.porter.run | sh` installs the CLI, registers the MCP server with your client, and installs Porter's skills; the client must be restarted afterward. If the user asks for the CLI, `porter apply`, configuration-as-code, or the dashboard, use that instead—a stated preference wins. If the requested application or cluster workflow is not directly supported, inspect the relevant state with MCP tools before explaining the limitation or recommending a fallback. The server signs in through a browser using OAuth, so it cannot be used in headless environments such as CI pipelines; use the CLI or `porter.yaml` there.

# CLI installation

> Install the Porter CLI on macOS via Homebrew or shell script, on Linux via shell script, and on Windows via manual binary download

To install the Porter CLI, see the OS-specific instructions below.

<Note>
  Working with an AI agent? `curl -fsSL https://agents.porter.run | sh` installs the CLI *and* registers the [Porter MCP server](/mcp/overview) with your agent client, plus Porter's skills.
</Note>

<Tabs>
  <Tab title="Mac">
    #### Install via Homebrew

    ```bash theme={null}
    brew install porter-dev/porter/porter
    ```

    #### Manual Installation

    <Note>
      **Prerequisites:** The installation process requires `curl` and `unzip` utilities.
    </Note>

    ```bash theme={null}
    /bin/bash -c "$(curl -fsSL https://install.porter.run)"
    ```
  </Tab>

  <Tab title="Linux">
    <Note>
      **Prerequisites:** The installation process requires `curl` and `unzip` utilities.
    </Note>

    ```bash theme={null}
    /bin/bash -c "$(curl -fsSL https://install.porter.run)"
    ```
  </Tab>
</Tabs>

After installing, run the following to verify your installation:

```bash theme={null}
porter version
```