Arcano Pi

Full pi coding agent configuration for the Arcano Co team — extensions, skills, agents, settings, and MCP servers in a single repo. Clone to ~/.pi/agent/ and you're done.

Quick Start (Fresh Machine)

# 1. Install pi
npm install -g @earendil-works/pi-coding-agent

# 2. Clone this config
mkdir -p ~/.pi
git clone git@github.com:arcano-co/pi ~/.pi/agent

# 3. Bootstrap
cd ~/.pi/agent && bash setup.sh

# 4. Add your API keys
cp auth.template.json auth.json
# Edit auth.json with real keys, or set env vars for your provider

# 5. Launch
pi

What's Included

Extensions (extensions/)

Extension	What it does
context7-docs	/context7_resolve and /context7_docs tools — up-to-date library docs
exa-search	/exa_search and /exa_fetch tools — web search and page reading
swarm-validate	/swarm_validate_idea — 6-persona AI business idea validation
web-tool-routing	Steers the LLM toward the right browser/scraping tool
mode-status	Shows current pi-modes state in the footer
rtk	Token-saver — transparently rewrites bash through rtk (requires brew install rtk)

Skills (skills/)

23 on-demand skills covering the full development lifecycle:

Area	Skills
Design & Planning	api-and-interface-design, spec-driven-development, planning-and-task-breakdown, idea-refine
Domain Modeling	domain-analysis, domain-driven-design
Implementation	incremental-implementation, test-driven-development, source-driven-development, code-simplification
Quality	code-review-and-quality, debugging-and-error-recovery, doubt-driven-development, ci-cd-and-automation
Security & Operations	security-and-hardening, shipping-and-launch, deprecation-and-migration
Performance	performance-optimization
Frontend	frontend-ui-engineering, browser-testing-with-devtools
Meta	context-engineering, git-workflow-and-versioning, documentation-and-adrs, using-agent-skills
Audit	financial-audit-trail

Agents (agents/)

6 persona definitions for swarm validation:

• skeptic.md, early-adopter.md, enterprise-buyer.md, budget-user.md, industry-expert.md, market-analyst.md

MCP Servers (mcp.json)

Pre-configured MCP servers (keys via env vars):

• github — repo/PR/issue management
• firecrawl — web scraping and crawling
• memory — persistent knowledge graph
• exa — web search
• railway — infrastructure management
• vercel — deployment
• ossinsight — GitHub analytics
• context7 — library documentation

Pi Packages (auto-installed by setup)

• pi-mcp-adapter — MCP protocol support
• pi-agent-extensions — Agent definition tools
• pi-modes — Plan/Ask/Edit/Review operational modes
• pi-memory — Persistent memory with daily logs, scratchpad, and optional qmd semantic search

Directory Layout

~/.pi/agent/           ← clone this repo here
├── settings.json       ← pi settings (provider, model, thinking, packages)
├── mcp.json            ← MCP server configs
├── setup.sh            ← bootstrap script
├── extensions/         ← custom TypeScript extensions
├── skills/             ← on-demand agent skills (SKILL.md)
├── agents/             ← agent persona definitions
├── prompts/            ← prompt templates (add your own)
└── themes/             ← custom themes (add your own)

Updating

cd ~/.pi/agent
git pull
pi update --extensions   # update pi packages too

Adding Your Own

• Skills: Drop SKILL.md files into skills/your-skill/
• Extensions: Add .ts files to extensions/
• Prompts: Add .md files to prompts/ — invoke with /filename
• Themes: Add .json files to themes/

Everything is auto-discovered by pi. /reload picks up changes without restarting.

Credits

Built on pi by Mario Zechner. Extension patterns from HazAT/pi-config and mitsuhiko/agent-stuff.