Get started

Install the CLI from this checkout, then use the shipped skill to work against either a local SQLite database or a deployed Powder server.

Building from source is not required. The README quickstart runs a released binary or the ghcr.io/misty-step/powder container image and gets a claimed card in a few copy-pasteable commands.

Install the binaries

git clone https://github.com/misty-step/powder.git
cd powder
cargo install --path crates/powder-cli
cargo install --path crates/powder-server
powder version

Start a local board

DB=./data/powder.db
mkdir -p "$(dirname "$DB")"
powder init-db --db "$DB" --show-secret
powder create-card --db "$DB" --id first-card --title "First card" --acceptance "proof exists" --status ready
powder list-ready --db "$DB" --limit 10
POWDER_DB_PATH="$DB" POWDER_AUTH_MODE=api-key POWDER_BIND_ADDR=127.0.0.1:4017 powder-server

Use the CLI remotely

Set POWDER_API_BASE_URL and POWDER_API_KEY to point the CLI at a deployed server. Read SKILL.md for the agent command contract.

export POWDER_API_BASE_URL=http://127.0.0.1:4017
export POWDER_API_KEY=<bootstrap-key>
powder list-ready --limit 10
powder claim first-card --agent codex

Next references

Read README.md for the current CLI route map, SKILL.md for the agent usage contract, and docs for production deployment notes.