Airic for Pi

Airic is a document-defined, trainable agent built as a Pi Coding Agent extension. It adds project-owned operating models, explicit modes and procedures, and reviewable reflection through ordinary .airic files.

Pi is an external host dependency, not bundled into Airic. Install Pi and Airic once, globally:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent airic-agent

Both Pi TUI and ACP use this one Airic installation. Do not also run pi install for Airic: it creates a second extension copy and can cause duplicate tool-name conflicts when ACP starts. If you previously installed it with pi install, run pi list and remove the listed Airic source with pi remove <source>.

For Pi TUI, find npm's global package directory:

npm root -g

Then start Pi with Airic's extension file, replacing <npm-global-root> with the printed path:

pi --extension <npm-global-root>/airic-agent/dist/extension.js

In the project you want to train, initialize Airic:

/airic init

Initialization creates editable copies of the default airic-core and airic-packsmith base packs plus a fixed .airic/project/ scope for project-owned procedures, standards, roles, policies, boundaries, precedents, lenses, and modes. Other official packs remain optional.

Reflection and the other durable-instruction authoring flows apply Core's placement contract before editing: an instruction must have an explicit owner, authoritative destination, fitting representation, discovery route, and loading route. Project methods remain Operating Model artifacts; concise runtime constraints that must enter every affected session may use the narrowest AGENTS.md or equivalent context file that the client actually loads. Installed third-party packs are not treated as their authoritative upstream source.

Use /airic pack list to inspect all official and project-local packs. Install an optional official pack with /airic pack install <pack-id>; disable keeps the local files and removes only its project-level enablement.

The same package also contains an ACP adapter for editors such as Zed. Run it after the global installation above:

airic acp

Configure the ACP client with command airic and argument acp. Both modes read Pi's normal configuration and installed capabilities; TUI-only extension UI remains specific to the terminal mode.