Connect AIWG to Pi Coding Agent

Prompt-first procedure: Describe the outcome you want in your agent conversation. The agent should select and load the appropriate AIWG assets, explain material changes, request any needed approval, and report verification evidence. Exact commands and flags appear only in the CLI reference.

For the complete first-time journey, start with Install, Connect, and Verify.

Pi support is experimental. AIWG uses Pi's native prompt templates and Agent Skills without adding an executable extension.

Install and deploy

Install Pi and AIWG, then deploy from the project root:

Use AIWG to complete this documented outcome: Install Pi and AIWG, then deploy from the project root
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

Restart Pi in the project and ask it to run the agent-owned context regeneration procedure. Verify the integration with:

Use AIWG to complete this documented outcome: Restart Pi in the project and ask it to run the agent-owned context regeneration procedure. Verify the integration with
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

Created resources

Resource	Location	Purpose
Project context	`AGENTS.md`	Directs Pi to `WORKSPACE.md` and `AIWG.md`
Portable skills and roles	`.agents/skills/*/SKILL.md`	Pi's cross-agent Agent Skills surface
AIWG standard skills	`.pi/.aiwg/skills/`	Receipted AIWG-managed skill projection
Prompt templates	`.pi/prompts/*.md`	User-facing AIWG commands

Pi searches `.pi/skills/` and `.agents/skills/` from the current directory up to the repository root. Prompt templates are direct children of `.pi/prompts/`; AIWG flattens command names where necessary to preserve Pi's non-recursive prompt discovery.

User scope

For user-level resources, Pi defaults to `~/.pi/agent`. If `PI_CODING_AGENT_DIR` is set, both Pi and AIWG use that directory instead. Preview either deployment without writes:

Use AIWG to complete this documented outcome: For user-level resources, Pi defaults to ~/.pi/agent. If PI_CODING_AGENT_DIR is set, both Pi and AIWG use that directory instead. Preview either deployment without writes
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

AIWG preserves user-authored Pi resources and trust decisions. It only owns files recorded in its deployment receipts.

For exact paths, limitations, and recovery steps, see the Pi operational reference.