Static copy

Copied from docs/en/getting-started/installation.md in https://github.com/poppy-team/prumo (MIT). Pinned to revision e91694d3959be1ed92757b34063efe0b2191821f, blob 33b543441db8880ff7ee1112ab1df7612eec0fdc. The source repository remains canonical; this copy is refreshed through a sync pull request, not live.

Installing Prumo

Prumo is distributed as a single static executable compiled in Go, with no external runtime dependencies (it does not require Python, Node.js, or compilers to be installed).

Quick Installation (Recommended)

Linux & macOS

# Download the official v0.6.0 executable
curl -fsSL https://github.com/poppy-team/prumo/releases/latest/download/prumo-linux-amd64 -o /usr/local/bin/prumo
chmod +x /usr/local/bin/prumo

# Verify the installation
prumo version

Global Environment Initialization

On first install, run setup to register the system manifest and detect AI tools on your $PATH:

prumo setup

The command will initialize the global ~/.prumo directory, which holds the connector registry and the update cache.

---

Integrity Verification and Diagnostics

To audit the host environment, the detected AI tools, and the executable's integrity:

prumo doctor

When run outside a project, prumo doctor analyzes the global environment; inside a project, it also analyzes the conformance of the repository's schemas and goals.

---

Autoupdate (Continuous Updates)

Prumo includes a built-in self-update subsystem with SHA-256 cryptographic verification, pulling directly from the official GitHub releases:

# Check whether new versions are available
prumo upgrade --check

# Update to the latest version
prumo upgrade

# Update to a specific version
prumo upgrade --version v0.6.1

---

Reversible and Safe Uninstallation

If you need to remove the global installation or reset caches:

# Remove global connectors and binaries
prumo uninstall

# Clear caches without affecting project data
prumo uninstall --purge-cache

IMPORTANT

Uninstalling never mutates or removes local repository directories (prumo.json, .ai/, docs/, and goal files remain 100% intact).