pi-tools
View and manage Pi-built extensions synced to Amp. Shows available tools, commands, and sync status.
- License 许可
- MIT
- 最近更新
- 2026-06-04
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- pi-tools
- description
- View and manage Pi-built extensions synced to Amp. Shows available tools, commands, and sync status.
03 SKILL.md 正文
Pi Tools
View and manage Pi-built extensions that have been synced to Amp.
Arguments
$ACTION: What to do (optional, defaults tolist)list- Show all synced Pi extensions and their toolssync- Force re-sync of Pi extensionsstatus- Show sync status and registry infoshow [extension]- Show details for a specific extension
Workflow
Step 1: Check Registry
Read the Pi extensions registry at .claude/pi-extensions-registry.json.
if [ -f ".claude/pi-extensions-registry.json" ]; then
echo "Registry found"
else
echo "No Pi extensions synced yet"
fi
Step 2: Execute Action
If $ACTION == list or no action specified:
Display all synced extensions:
## Pi Extensions
| Extension | Tools | Commands | Last Modified |
|-----------|-------|----------|---------------|
| [name] | [count] | [count] | [date] |
### Tools Available
**[extension-name]:**
- `tool_name` - Description
- `tool_name_2` - Description
**[extension-name-2]:**
- ...
If $ACTION == sync:
-
Run the sync hook manually:
node .claude/hooks/pi-extensions-sync.cjs -
Report what changed:
- New extensions added
- Extensions updated
- Extensions removed
If $ACTION == status:
Display sync metadata:
- Last sync timestamp
- Number of extensions
- Registry file location
- Generated skills location
If $ACTION == show [extension]:
Read the generated skill file:
cat ".claude/skills/pi-generated/pi-[extension]/SKILL.md"
Display full details:
- Description
- All tools with parameters
- All commands
- Source file location
Output Format
List View
## Pi Extensions Synced to Amp
**Last sync:** 2026-02-03T12:00:00Z
### amp-mcp-bridge
*Bridges Pi to Amp's MCP servers for task and calendar management*
**Tools:**
- `amp_task` - Manage tasks (create, complete, list, suggest)
- `amp_calendar` - Access calendar events (today, upcoming, list)
**Commands:**
- `/amp-tasks` - List current tasks
- `/amp-today` - Show today's events
---
Run `/pi-tools sync` to refresh from .pi/extensions/
Status View
## Pi Extensions Status
**Registry:** .claude/pi-extensions-registry.json
**Skills:** .claude/skills/pi-generated/
**Source:** .pi/extensions/
**Stats:**
- Extensions: 1
- Total tools: 2
- Total commands: 2
**Last sync:** 2026-02-03T12:00:00Z
**Sync triggers:**
- SessionStart hook (automatic)
- `/pi-tools sync` (manual)
Integration Notes
How Sync Works
- SessionStart hook runs
pi-extensions-sync.cjs - Scans
.pi/extensions/*.tsfor TypeScript files - Parses each file to extract:
- JSDoc descriptions
pi.registerTool()callspi.registerCommand()calls
- Generates skill stubs in
.claude/skills/pi-generated/ - Updates registry with metadata
- Outputs summary to session context
Skill Naming
Pi extension skills are prefixed with pi: to distinguish from native Amp skills:
pi:amp-mcp-bridge- MCP bridge extensionpi:custom-tool- Custom extension
Generated skill folders use pi- prefix:
.claude/skills/pi-generated/pi-amp-mcp-bridge/SKILL.md
When to Use Pi vs Amp
Use Pi tools when:
- Working in the Pi environment
- Need direct tool execution
- Building new extensions
Use Amp context when:
- Planning work that involves Pi capabilities
- Documenting what tools are available
- Cross-referencing with Amp knowledge
Edge Cases
- No .pi/extensions/ directory: Silent - Pi not configured
- Empty extensions directory: Report "No Pi extensions found"
- Parse errors: Skip malformed files, report warnings
- Deleted extensions: Clean up orphaned skill stubs
04 同仓库更多 Skills
zoom-setup
Connect Zoom to Amp for meeting recordings, scheduling, and transcript context
xray
Understand what just happened under the hood - learn AI by seeing it in action
week-review
Review week's progress with concrete accomplishments (not fake percentages), pattern detection, and goal tracking.
week-plan
Set weekly priorities and plan the week ahead with intelligent suggestions based on goals, calendar shape, and task effort.
triage
Strategically route orphaned files and extract scattered tasks
trello-setup
Connect Trello to Amp for visual Kanban task sync