majiayu000 Pi-Messenger Crew Skill
Use pi-messenger for multi-agent coordination and Crew task orchestration.
Quick Reference
Join the Mesh (Required First)
pi_messenger({ action: "join" })
Check Status
pi_messenger({ action: "status" })
pi_messenger({ action: "list" }) // See other agents
Crew Workflow
1. Install Crew Agents (one-time)
pi_messenger({ action: "crew.install" })
pi_messenger({ action: "crew.agents" }) // Verify 5 agents
2. Plan from PRD
// Auto-discover PRD.md in current directory
pi_messenger({ action: "plan" })
// Or specify path
pi_messenger({ action: "plan", prd: "path/to/PRD.md" })
3. Work on Tasks
// Single wave (runs ready tasks once)
pi_messenger({ action: "work" })
// Autonomous (keeps running until done/blocked)
pi_messenger({ action: "work", autonomous: true })
4. Task Management
pi_messenger({ action: "task.list" })
pi_messenger({ action: "task.ready" }) // Tasks with no pending deps
pi_messenger({ action: "task.show", id: "task-1" })
pi_messenger({ action: "task.start", id: "task-1" })
pi_messenger({ action: "task.done", id: "task-1", summary: "What was done" })
pi_messenger({ action: "task.block", id: "task-1", reason: "Why blocked" })
pi_messenger({ action: "task.unblock", id: "task-1" })
pi_messenger({ action: "task.reset", id: "task-1" })
pi_messenger({ action: "task.reset", id: "task-1", cascade: true }) // Reset dependents too
5. Review
// Review a task implementation
pi_messenger({ action: "review", target: "task-1" })
// Review the overall plan
pi_messenger({ action: "review", target: "plan", type: "plan" })
File Coordination
// Reserve files before editing
pi_messenger({ action: "reserve", paths: ["src/index.ts", "src/types.ts"], reason: "Working on core" })
// Release when done
pi_messenger({ action: "release" })
Agent Communication
// Rename yourself
pi_messenger({ action: "rename", name: "MyAgentName" })
// Send message to specific agent
pi_messenger({ action: "send", to: "OtherAgent", message: "Hello!" })
// Broadcast to all
pi_messenger({ action: "send", broadcast: true, message: "Announcement" })
Typical Crew Session
// 1. Join
pi_messenger({ action: "join" })
// 2. Plan (spawns planner agent)
pi_messenger({ action: "plan" })
// 3. Check tasks
pi_messenger({ action: "task.list" })
// 4. Work
pi_messenger({ action: "work", autonomous: true })
// 5. Status
pi_messenger({ action: "status" })
Data Storage
Crew stores data in .pi/messenger/crew/:
.pi/messenger/crew/
├── config.json # Project config (concurrency, etc.)
├── plan.json # Plan metadata
├── plan.md # Planner output
├── tasks/
│ ├── task-1.json # Task metadata
│ ├── task-1.md # Task spec
│ └── ...
├── blocks/
│ └── task-N.md # Block context
└── artifacts/ # Debug artifacts
Config Options
Create .pi/messenger/crew/config.json:
{
"concurrency": {
"workers": 3 // Max parallel workers (default: 2)
},
"planning": {
"maxPasses": 3 // Max planner passes before accepting last output
}
}