pichu 0.1.2

⚡ pichu — code, compile, conquer

⚡ pichu

Code, compile, conquer.
Open-source coding agent that lives in your terminal.

Home • Star • Report Bug • Submit PR • PyPI

---

Features

• 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

Quick Start

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"

Documentation

Getting Started

• Quick Install
• Usage Guide

Development and Operations

• Development Guide
• Deployment Guide

Module and Architecture References

• 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

Support the Project

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.

License

Apache 2.0 — see LICENSE.