Meta-learning extension for pi coding agent that captures debugging discoveries as reusable skills. Ported from Claudeception.
The idea: when you spend time debugging a cryptic error / codebase / whatever, you usually learn something that you want to save for the future. With piception, you can save that knowledge as a agentic skill (for pi/claude/codex/you name it). Skill setup follows the open agent skills standard.
Via Nix (recommended):
# Install globally
nix profile install github:otahontas/pi-piception
# Or via Home Manager
programs.pi.piception.enable = true;Via Git:
git clone https://github.com/otahontas/pi-piception ~/.pi/agent/extensions/piceptionPi auto-loads extensions on startup, no config needed.
Verify it loaded:
piType /piception stats - should show session statistics.
1. Do real work
Have a conversation involving debugging or problem-solving:
User: Run npm test
Assistant: [shows failing test with error]
User: Why is UserService undefined?
Assistant: [investigates, finds circular dependency]
User: How do I fix it?
Assistant: [suggests extracting interface, shows fix]
User: That worked!
2. Save the learning
Run: /piception
3. Review and create
Interactive wizard lets you:
- Edit skill name (kebab-case)
- Edit description (add trigger keywords)
- Edit full content in your editor
- Choose location (all projects vs. this project)
- Confirm creation
4. Skill loads automatically next time
When you hit similar errors, pi loads the skill automatically based on semantic matching.
- Piception injects a reminder after each request.
- If the work involved non-obvious debugging or discovery, run
/piception.
- Run
/piceptionanytime to extract skills from the session.
Uses devenv with Nix for reproducible environment (mostly for formatting and git pre-commits).
Install prerequisites:
Available commands:
Check the justfile for all recipes.
MIT