# Pi Coding Agent Config

> Reference for customizing and configuring pi-coding-agent (pi). Covers settings files (settings.json), extensions, skills, prompt templates, package management, and programmatic usage via the SDK. Use when asked about pi configuration or customization. Use when this capability is needed.

- Skill: `tomevault-io/pi-coding-agent-config-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/pi-coding-agent-config-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/pi-coding-agent-config-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/pi-coding-agent-config-2

---


# pi-coding-agent Configuration & Customization Guide

Comprehensive reference for customizing pi-coding-agent (pi).

## Reference Documents

Read the following documents as needed:

### Context Files

- [context-files.md](references/context-files.md) - How pi loads `AGENTS.md` / `CLAUDE.md` context files and system prompt customization (`SYSTEM.md`, `APPEND_SYSTEM.md`).

### Settings

- [settings.md](references/docs/settings.md) - All options for settings files (`~/.pi/agent/settings.json`, `.pi/settings.json`). Model, theme, compaction, retry, and more.

### Extensions

- [extensions.md](references/docs/extensions.md) - How to create TypeScript extensions. Custom tools, event hooks, custom UI, command registration, etc.
- [Extension examples](references/examples/extensions/) - Numerous sample extensions.

### Skills

- [skills.md](references/docs/skills.md) - How to create Agent Skills. SKILL.md format, frontmatter, discovery rules.

### Prompt Templates

- [prompt-templates.md](references/docs/prompt-templates.md) - How to create prompt templates invoked via `/name`. Argument support.

### Package Management

- [packages.md](references/docs/packages.md) - How to share extensions, skills, themes, etc. as npm/git packages. `pi install`, `pi remove`, `pi update`.

### SDK (Programmatic Usage)

- [sdk.md](references/docs/sdk.md) - How to use pi as a library to build custom UIs or automated pipelines.
- [SDK examples](references/examples/sdk/) - Step-by-step examples from minimal to full control.

## Typical Configuration Workflow

1. **Global settings**: Edit `~/.pi/agent/settings.json` (shared across all projects)
2. **Project settings**: Edit `.pi/settings.json` (project-specific, overrides global)
3. **Add extensions**: Place TypeScript files in `.pi/extensions/`
4. **Add skills**: Create `.pi/skills/<name>/SKILL.md`
5. **Prompt templates**: Create `.pi/prompts/<name>.md`
6. **Use packages**: `pi install npm:<package>` or `pi install git:<repo>`

Use `read` to load the reference documents above as needed.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/yukukotani) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->