How mygu/claude-code-haha works
Claude Code Haha is a local Claude Code-compatible terminal assistant, supporting interactive Ink TUI use and documented headless --print mode with configurable Anthropic-compatible APIs. The principal workflow is user input through the terminal interface into query/agent processing, which can use tools and return results; commands, MCP, plugins, and Skills add capabilities. Session persistence and shared runtime state support ongoing work. The README describes recovery mode, but its entrypoint is absent from the supplied tree. Some runtime wiring is unsampled, so uncertain links are omitted or marked unverified.
Main entry points: QueryEngine.ts Query engine · query.ts Query lifecycle · ink.ts Ink terminal UI · sessionStorage.ts Session storage
Components 13
User interaction
- Ink terminal UI
src/ink.ts
Agent runtime
- Query engine
src/QueryEngine.ts - Query lifecycle
src/query.ts - Tool system
src/Tool.ts
Extensions
- Slash commands
src/commands.ts - MCP connections
src/services/mcp/MCPConnectionManager.tsx - Plugin installation
src/services/plugins/PluginInstallationManager.ts - Skills discovery
src/commands.ts
State and persistence
- Runtime state
src/bootstrap/state.ts - Session storage
src/utils/sessionStorage.ts - Transcript loading
src/utils/sessionStoragePortable.ts
Other components
- User
- Compatible API
Connections 9
- User → Ink terminal UI: enters prompt
README.md - Ink terminal UI → Query engine: submits work
- Query engine → Query lifecycle: delegates query
src/QueryEngine.ts - Query engine → Tool system: uses tools
src/QueryEngine.ts - Query lifecycle → Tool system: uses tools
src/query.ts - Query lifecycle → Compatible API: requests model
README.md - Slash commands → Skills discovery: discovers skills
src/commands.ts - Runtime state → Session storage: tracks sessions
src/utils/sessionStorage.ts - Session storage → Transcript loading: loads transcript
src/utils/sessionStorage.ts