dotpi

Pi Coding Agent toolkit — a collection of extensions, skills, and agents for pi. Opinionated but modular — use what you want.

Extensions

Extension	Description
ui-pack.ts	Compact tool renderers for read/bash/edit/write + rotating working animation
statusline.ts	Custom footer with folder name, git branch, context usage bar, and model info
ask.ts	Interactive structured Q&A — the model asks you questions with pre-crafted options
brave-search.ts	web_search tool powered by the Brave Search API
firecrawl.ts	firecrawl_scrape tool — scrape any URL to clean markdown
guard-rails.ts	Blocks dangerous bash commands and warns on sensitive file edits
openrouter.ts	OpenRouter provider with example model config
todo-phases.ts	Phased task tracking with progress widget, auto-normalization, and /todos command
commit-helper.ts	/commit command — generates conventional commit messages with AI
subagent/	Delegate tasks to isolated pi subprocesses (single, parallel, or chain mode)

Skills

Skill	Description
brainstorming	Explore intent, requirements, and design before implementation
systematic-debugging	Root cause investigation before proposing fixes
test-driven-development	Red-green-refactor — no production code without a failing test
verification-before-completion	Fresh verification evidence before claiming work is done

Agents

Agent	Description
explore	Read-only codebase investigation
reviewer	Code review with priority-based findings (P0–P3)
task	General-purpose implementation agent
quick_task	Fast agent for simple, mechanical changes

Installation

Copy the files you want into your pi agent directory:

# Clone the repo
git clone https://github.com/aibuildersmx/dotpi.git
cd dotpi

# Copy everything
cp -r extensions/ ~/.pi/agent/extensions/
cp -r skills/ ~/.pi/agent/skills/
cp -r agents/ ~/.pi/agent/agents/

# Or cherry-pick individual files
cp extensions/guard-rails.ts ~/.pi/agent/extensions/
cp skills/brainstorming/SKILL.md ~/.pi/agent/skills/brainstorming/

Then install extension dependencies:

cd ~/.pi/agent/extensions
npm install

Requirements

• pi coding agent
• Node.js 20+
• API keys in ~/.pi/.env (for extensions that need them):

  BRAVE_API_KEY=your-brave-search-key
  FIRECRAWL_API_KEY=your-firecrawl-key
  OPENROUTER_API_KEY=your-openrouter-key
  

Credits

Built by AI Builders MX

License

MIT