skills.rest
cbrostrom
cbrostromCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

pi

Configures Pi coding agent models, MCP servers, hooks, and subagents for daily-driver use.

Updated Nov 25, 2024
Search Tags:#hooks#dotfiles#mcp#model configuration#pi#coding agent#cursor sdk
One-click install
npx skills add https://github.com/cbrostrom/dotfiles --skill pi-cbrostrom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pi
Source: https://github.com/cbrostrom/dotfiles/tree/main/stow/agents/.agents/skills/pi
Command: npx skills add https://github.com/cbrostrom/dotfiles --skill pi-cbrostrom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing a Pi coding agent setup involves scattered configuration across model allowlists, MCP server wiring, hook validation, and cost controls, and this Skill consolidates that operational knowledge into one reference. ## Core Features & Use Cases - Scoped Model Management: Documents the enabledModels allowlist, Ctrl+P cycling, and the cursor-model-guard extension that reverts non-allowlisted cursor/* selections to control Cursor plan spend. - MCP Wiring: Explains the two-layer MCP setup with hot-path servers in mcp.json and everything else routed through pi-mcporter with indexed exposure. - Hooks, Subagents, and Memory: Covers pi-yaml-hooks validation commands, Explore subagent usage for parallel read-only sweeps, and higgins memory commands like .remember and .recall. - Use Case: When Pi bills unexpected Cursor spend or a hook stops firing, use this Skill to check the model guard, validate hooks.yaml, and verify environment variables in configs/.env. ## Quick Start Ask the agent to check which Pi models are currently scoped and whether the cursor-model-guard is blocking non-allowlisted selections.

Frequently Asked Questions about pi

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I change the active model in the Pi coding agent?▼

Cycle through scoped models with Ctrl+P or Shift+Ctrl+P, or list them with /scoped-models. The full registry is available via /model or pi --list-models <provider>, but only models in enabledModels are selectable.

How do I set up MCP servers in Pi?▼

Hot-path servers like higgins and deja go in ~/.pi/agent/mcp.json with directTools enabled. Everything else routes through pi-mcporter with defaultExposure set to index, discovered via the mcporter tool's search, describe, and call flow.

Why does Pi revert my Cursor model selection?▼

The cursor-model-guard extension reverts any cursor/* model not on the allowlist, permitting only Auto and Composer pools. This is a cost control so usage bills against the Cursor plan's included pools rather than on-demand spend.

How do I validate Pi hooks configuration?▼

Run /hooks-validate to check hooks.yaml syntax, /hooks-status to see current state, and /hooks-reload to apply changes. The global hooks file lives at ~/.pi/agent/hook/hooks.yaml, symlinked from dotfiles.

When should I use subagents instead of the main Pi session?▼

Use the Explore subagent for fast read-only codebase sweeps and run_in_background for parallel information gathering. Default to the main thread unless parallelism gives a clear win, since Explore uses Claude Opus and increases cost.

Related Skills

Explore More Software Engineering Skills→
davidorexdavidorex
25

pi-project-workflows

Install a meta-package re-exporting pi-project, pi-workflows, and pi-behavior-monitors.

Community
Intermediate
ruvnetruvnet
70.1k

agent-safla-neural

Implements self-learning neural agents with persistent four-tier memory and feedback loops.

Community
Intermediate
arbisoftarbisoft
4

agent-payment-x402

Enforce per-task budgets and wallet controls for autonomous x402 payments via MCP tools.

Official
Advanced
yandy-ryandy-r

implement-plan

Orchestrate parallel plan execution with dependency-aware implementor agent batches.

Community
Advanced