Pi setup¶
Pi is a stable LazyAI target for Pi agents, skills, prompt templates, TypeScript extensions, system prompts, and settings.
Generated structure¶
.
├── AGENTS.md
└── .pi/
├── agents/<agent>.md
├── skills/<skill>/SKILL.md
├── prompts/<prompt>.md
├── extensions/<extension>.ts
├── extensions/<extension>/index.ts
├── SYSTEM.md
├── APPEND_SYSTEM.md
└── settings.json
```mermaid
flowchart LR
AI[".ai/ canonical source"] --> A[".pi/agents"]
AI --> S[".pi/skills"]
AI --> P[".pi/prompts"]
LIB["Pi library assets"] --> E[".pi/extensions"]
LIB --> Y[".pi/SYSTEM.md + APPEND_SYSTEM.md"]
AI --> Z[".pi/settings.json"]
MCP[".ai/mcp.json"] -. no emitted config .-> N["Pi MCP no-op"]
## Pi concepts LazyAI uses
| Pi concept | LazyAI source |
|---|---|
| Root instructions | `AGENTS.md` |
| Agent profiles | canonical agent markdown under `.pi/agents/` |
| Skills | Agent Skills-compatible `SKILL.md` directories |
| Prompts | prompt markdown under `.pi/prompts/` |
| Extensions | TypeScript extensions under `.pi/extensions/` (flat files or directory `index.ts` layouts) |
| System prompts | `.pi/SYSTEM.md` and `.pi/APPEND_SYSTEM.md` |
| Settings | `.pi/settings.json` / `~/.pi/agent/settings.json` resource references |
| MCP | no capability declared; no Pi MCP config is emitted |
## LazyAI options
| Use case | Command |
|---|---|
| Add Pi during init | `lazyai-cli init --scope project --tools pi --preset standard --no-interactive` |
| Add Pi later | `lazyai-cli add --tools pi --no-interactive` |
| Include prompts/skills from full preset | `lazyai-cli init --scope project --tools pi --preset full --no-interactive` |
| Build a Pi bundle | `lazyai-cli build-plugin --target pi --out ./dist/pi` |
## Example
```bash
lazyai-cli init \
--scope project \
--tools pi \
--preset full \
--name my-app \
--no-interactive
lazyai-cli doctor
Readiness notes¶
- Support level: stable.
- Project, workspace, and global (
~/.pi/) scopes are supported. - Pi has no
.pi/hooksdirectory; LazyAI emits safety behavior as.pi/extensions/. lazyai-cli compile --tool pireads canonical MCP state but emits no MCP file for Pi.- Pi settings compilation emits resource references for
extensions,skills,prompts, and a local package-root reference; theme preferences remain user-owned. - Pi can load
.pi/SYSTEM.mdand.pi/APPEND_SYSTEM.md; LazyAI emits both when present in the Pi library.