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

# Installation

> Install partio on macOS, Linux, or from source

# Installation

## Package managers

<Tabs>
  <Tab title="macOS (Homebrew)">
    ```bash theme={null}
    brew install partio-io/tap/partio
    ```
  </Tab>

  <Tab title="Linux (Homebrew)">
    ```bash theme={null}
    brew install partio-io/tap/partio
    ```

    Homebrew on Linux works the same as macOS.
  </Tab>

  <Tab title="Go Install">
    Requires Go 1.25 or later:

    ```bash theme={null}
    go install github.com/partio-io/cli/cmd/partio@latest
    ```

    Make sure `$GOPATH/bin` (usually `~/go/bin`) is in your `PATH`.
  </Tab>

  <Tab title="From Source">
    ```bash theme={null}
    git clone https://github.com/partio-io/cli.git
    cd cli
    go build -o partio ./cmd/partio
    sudo mv partio /usr/local/bin/
    ```
  </Tab>
</Tabs>

## Verify installation

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

You should see:

```
partio v0.1.0
```

## Shell completions

partio is built with [Cobra](https://github.com/spf13/cobra) and supports shell completions:

<Tabs>
  <Tab title="Bash">
    ```bash theme={null}
    partio completion bash > /etc/bash_completion.d/partio
    ```
  </Tab>

  <Tab title="Zsh">
    ```bash theme={null}
    partio completion zsh > "${fpath[1]}/_partio"
    ```
  </Tab>

  <Tab title="Fish">
    ```bash theme={null}
    partio completion fish > ~/.config/fish/completions/partio.fish
    ```
  </Tab>
</Tabs>

## Requirements

* **Git** 2.25 or later (for orphan branch support)
* **macOS** or **Linux** (Windows support is planned)

## Upgrading

<Tabs>
  <Tab title="Homebrew">
    ```bash theme={null}
    brew upgrade partio
    ```
  </Tab>

  <Tab title="Go Install">
    ```bash theme={null}
    go install github.com/partio-io/cli/cmd/partio@latest
    ```
  </Tab>
</Tabs>

After upgrading, run `partio doctor` in your repositories to verify everything is healthy.

## Uninstalling

1. Disable partio in each repository:

```bash theme={null}
partio disable --remove-data
```

2. Remove the binary:

<Tabs>
  <Tab title="Homebrew">
    ```bash theme={null}
    brew uninstall partio
    ```
  </Tab>

  <Tab title="Manual">
    ```bash theme={null}
    rm $(which partio)
    ```
  </Tab>
</Tabs>

3. Optionally remove the global config:

```bash theme={null}
rm -rf ~/.config/partio
```