Get started

Installation and updates

Requirements

  • macOS or Linux. Native Windows is not supported.

  • A terminal at least 80 columns wide and 16 rows tall.

  • A kubeconfig for cluster access, including any authentication helper it needs.

Plous includes Kubernetes and Helm libraries. You do not need   kubectl   or   helm   for normal use. Plous is still in early development.

Install with Homebrew

sh

brew install simjay/tap/plous plous --version plous

Homebrew installs a bottle when available, or builds from source. See the tap for supported bottle platforms.

Published releases and development docs

Choose website documentation matching   plous --version  . Development docs follow   main   and may describe unreleased features.

Standalone MCP and   plous setup   require v0.0.3 or newer.

Build from source

You need Git, Make, and Go 1.26.4 or newer.

sh

git clone https://github.com/simjay/plous.git cd plous make build ./bin/plous

This builds development   main  . Website tools are separate and are not needed to build Plous.

Install on your PATH

Homebrew handles this automatically. For a source build, copy the executable to a directory on PATH:

sh

mkdir -p "$HOME/.local/bin" install -m 755 bin/plous "$HOME/.local/bin/plous"

Add   ~/.local/bin   to PATH if needed, or launch   ~/.local/bin/plous   directly.

Update

Close Plous and back up its data. Early development builds can change data formats.

For Homebrew:

sh

brew update brew upgrade plous plous --version

For a source installation, update the checkout and run   make build  . Replace any executable you copied elsewhere. Rebuilding the checkout does not update that separate copy.

Distribution archives

GitHub releases include macOS and Linux archives for amd64 and arm64. Each contains the executable, license, and Markdown guides.

Maintainers build them with   make dist  .

Uninstall

sh

brew uninstall plous

For a manual installation, remove the executable you installed.

Uninstalling keeps data in   ~/.plous/   or the chosen   --data-dir  . That includes credentials and conversations. See Data and privacy before deleting a profile.

View source

Plous · Open source · Early development

Search Plous docs

Search the documentation.

Documentation versions