pi-aia-workspace

One-command installer for the Ai Applied pi stack — the set of pi packages used to configure Ai Applied workspaces and pi agents in general.

Installs everything through pi's native pi install npm:<pkg> mechanism, so every package is a first-class top-level install registered in settings.json — individually updatable with pi update npm:<pkg>, no bundling, no duplication.

What it installs

Package	Purpose
pi-vigilant	Spec-memory + feedback-memory: capture, compile, and verify hard specs and behavior feedback
pi-aia-asf	Agentic Software Factory: gated/automatic software-development flow with mechanical verification
pi-aia-browser	Browser automation tools (browser_*) for testing web surfaces
pi-smart-web-search	Web search tools
pi-smart-fetch	Web fetch/read tools
pi-vision-handoff	Screenshot vision handoff for text-only models
pi-intercom	Cross-session coordination
pi-safe-compact	Safer session compaction
@oleg_tarasov/pi-compaction-fix	Compaction continuation fix

Install

Requires pi (npm install -g @earendil-works/pi-coding-agent).

One command (no clone, no GitHub):

npx pi-aia-workspace

Via pi (fetches the package, then runs its installer):

pi install npm:pi-aia-workspace
bash ~/.pi/agent/npm/node_modules/pi-aia-workspace/scripts/install.sh

The installer is idempotent — safe to re-run at any time (it upgrades any package that has a newer version).

Options

./scripts/install.sh --dry-run              # show what would be installed
./scripts/install.sh --skip=pi-intercom     # skip specific packages
./scripts/install.sh --only=pi-vigilant,pi-aia-asf   # install a subset
./scripts/install.sh --pin=0.1.3            # pin all packages to a version
PI_AIA_PIN=0.1.3 ./scripts/install.sh       # same via env
PI_CODING_AGENT_DIR=/path ./scripts/install.sh  # install into a specific agent home

After install

Restart pi (or start a new session) so the new packages load, then confirm:

pi list

Development

npm test    # runs test-install.sh against fresh sandbox agent homes

Release

npm run release [patch|minor|major]

License

MIT