pi-aia-workspace

One-command installer for the Ai Applied pi stack (pi-vigilant, pi-aia-asf, pi-aia-browser, pi-smart-web-search, pi-smart-fetch, pi-vision-handoff, pi-intercom, pi-safe-compact, compaction-fix).

Packages

Package details

package

Install pi-aia-workspace from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:pi-aia-workspace

Package: pi-aia-workspace
Version: 0.1.3
Published: Sep 1, 2026
Downloads: 576/mo · 43/wk
Author: bruno_aia
License: MIT
Types: package
Size: 11.9 KB
Dependencies: 0 dependencies · 0 peers

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

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