<!-- Generated from the canonical OpenPost public page. Do not edit this build artifact. -->

Title: CLI Installation
Description: Install the OpenPost CLI when you want to manage a running OpenPost instance from a terminal or automation job.
Canonical: https://docs.openpo.st/cli/installation
Source: [https://docs.openpo.st/cli/installation](https://docs.openpo.st/cli/installation)

# CLI Installation

Install the OpenPost CLI when you want to manage a running OpenPost instance from a terminal or automation job.

Other operating systems and architectures do not have a maintained release binary.

## Install from GitHub Releases

The install script downloads the latest matching `openpost-cli-*` release asset and installs it as `openpost`:

```sh
curl -fsSL https://raw.githubusercontent.com/getopenpost/openpost/main/scripts/install-cli.sh | sh
```

It supports Linux on `amd64` and `arm64`, and macOS on Apple Silicon (`arm64`). To install the desktop MCP stdio proxy at the same time:

```sh
curl -fsSL https://raw.githubusercontent.com/getopenpost/openpost/main/scripts/install-cli.sh | sh -s -- --with-mcp
```

That installs the matching `openpost-mcp-*` release asset as `openpost-mcp`.

## Manual Install

Download the matching CLI binary from [GitHub Releases](https://github.com/getopenpost/openpost/releases/latest), then put it on your `PATH`.

```sh
chmod +x openpost-cli-linux-amd64
sudo mv openpost-cli-linux-amd64 /usr/local/bin/openpost
openpost --version
```

For MCP clients, also download the matching `openpost-mcp-*` asset and put it on your `PATH` as `openpost-mcp`.

## Build from Source

From the repository root:

```sh
devenv shell -- bash -lc 'cd cli && go build -ldflags="-s -w" -o ../openpost ./cmd/openpost'
```

Or from inside `cli/`:

```sh
go build ./cmd/openpost
```

## First Run

```sh
openpost instance add local http://localhost:8080
openpost instance use local
openpost auth login http://localhost:8080
openpost workspace list
openpost workspace use personal
```

For every command and flag, see the [generated CLI reference](https://docs.openpo.st/reference/cli).
