Code, compile, conquer.
Open-source coding agent that lives in your terminal.
Home • Star • Report Bug • Submit PR • PyPI
- Composable tool stack — files, shell, web, tasks, and memory in one agent
- Sub-agents & task orchestration — delegate, isolate, and coordinate complex workflows
- MCP ecosystem integration — connect external MCP servers as native tools
- Context management — token-aware compaction, pruning, and usage tracking
- Session management — persistent transcripts, resume, rewind, and fork sessions
- Memory system — global and project memory with structured retrieval
- Hooks & automation — lifecycle hooks for tool use, compaction, and agent control
- Interactive terminal UX — 29 slash commands for runtime control and diagnostics
- Safety & reliability — workspace trust prompt, sandboxing, approvals, retries, and audit logging
Install pichu (recommended: one-line installer):
- See docs/install.md
# Start interactive mode
pichu
# Configure model/provider inside the session
/login
# Initialize project
/init
# Ask for a one-off task
pichu "explain this repo"- Agent Module — runtime loop, events, session lifecycle
- Client Module — LLM client, streaming, retry
- Commands Module — slash command system
- Config Module — configuration schema and loading
- Context Module — context management and compaction
- Hooks Module — lifecycle hook engine
- Logging Module — runtime and audit logging
- MCP Module — MCP server integration
- Safety Module — approval and sandbox policies
- Sub-agents Module — sub-agent orchestration
- Task Management — task system architecture
- Tool Management — tool registry and execution
- UI Module — terminal UI architecture and rendering pipeline
- Utils Module — shared runtime utilities
If you find this project useful:
- ⭐ Star it on GitHub to show support
- 🐛 Open issues to report bugs or suggest features
- 🔧 Submit a PR to improve the project
- 💡 Share it with others who might benefit
Contributions of any size are welcome.
Apache 2.0 — see LICENSE.