Pieverse Docs
Purr CLI

Installation

How to install and configure the purr CLI.

Installation

Install purr

Install the purr CLI from GitHub Releases:

curl -fsSL https://raw.githubusercontent.com/Pieverse-Eng/purr-cli/main/install.sh | bash

This installs the purr binary to ~/.purrfectclaw/bin/purr.

To pin a specific version:

curl -fsSL https://raw.githubusercontent.com/Pieverse-Eng/purr-cli/main/install.sh | PURR_VERSION=v0.1.6 bash

Verify:

purr version

Add purr to PATH

grep -q '.purrfectclaw/bin' ~/.zshrc 2>/dev/null || \
  echo 'export PATH="$HOME/.purrfectclaw/bin:$PATH"' >> ~/.zshrc

Configuration

purr reads credentials from environment variables or from values set via purr config set. Environment variables take precedence.

Set config values

purr config set api-url "https://purr.pieverse.io"
purr config set api-token "<your-api-key-or-access-token>"
purr config set instance-id "<your-instance-id>"

Verify:

purr config list

Environment variable overrides

VariableDescription
WALLET_API_URLPlatform API base URL
WALLET_API_TOKENAuth token (API key or JWT access token)
INSTANCE_IDInstance or agent identifier

If you sourced ~/.purrfectclaw/.env after registration, purr is already configured — environment variables set there take precedence over the config file.

On this page