Pi Coding Agent Configuration

Configuration for pi-coding-agent, a minimal terminal coding agent.

Structure

~/.config/pi/agent/
├── settings.json    # Global settings (provider, model, thinking)
├── extensions/      # TypeScript extensions
│   └── claude-hooks.ts  # Wrapper for Claude Code hook binaries
├── skills/          # Skills directory (SKILL.md format)
└── README.md

Extensions

claude-hooks.ts

Wraps the Go-based Claude Code hook binaries to provide consistent hook behavior:

Pi Event	Claude Hook Binary	Purpose
session_start	claude-hooks-initialize-session	Session initialization
session_shutdown	claude-hooks-save-session	Save session summary
tool_call	claude-hooks-validate-git-push	Block unsafe git push
tool_result	claude-hooks-capture-tool-output	Capture tool output
tool_result	claude-hooks-update-terminal-title	Update terminal title

Skills

Pi is compatible with Claude Code skills format. Skills are configured in settings.json:

{
  "skills": [
    "~/.config/claude/skills"
  ]
}

This loads all skills from the Claude skills directory automatically.

Settings

The settings.json configures:

defaultProvider: LLM provider (vertex, anthropic, openai, etc.)
defaultModel: Model to use
enabledModels: Models available for cycling (Ctrl+P)
defaultThinkingLevel: off, low, medium, high, xhigh
steeringMode: Message delivery control

Usage

# Start pi in current directory
pi

# Start with specific prompt
pi "explain this codebase"

# Use a specific skill
pi "/Git:commit"