Orpheus Cli

Orpheus CLI

An experimental AI coding agent built to explore multi-model orchestration, tool systems, and agentic workflows.

About This Project

Orpheus CLI is a **learning experiment**, not a production tool. I built it to deeply understand how coding agents work - from tool orchestration to memory systems to multi-model coordination.

This project represents my journey exploring:

• How to build effective AI coding assistants
• Multi-model orchestration patterns
• Tool systems and agent architectures
• The real complexity behind "simple" agentic workflows

**If you're looking for a production-ready coding agent, check out [Claude Code](https://github.com/anthropics/claude-code), [Cursor](https://cursor.sh), or [Aider](https://github.com/paul-gauthier/aider).**

What I Built

• Multi-model orchestration - A "planner" model coordinating specialist agents (Claude for coding, Codex for review, Gemini for documentation)
• Unified tool registry - AGNO-inspired tool system with structured responses
• Pattern memory - SQLite + FTS5 for storing and recalling successful refactoring patterns
• Git-aware context - Automatic workspace snapshots with branch, commits, and dirty files
• Session persistence - Save/resume sessions with full context restoration
• Streaming TUI - Bubble Tea interface showing real-time tool execution

What I Learned

---

A deep dive into the philosophy, design decisions, and lessons learned from building an experimental AI coding agent.

Philosophy & Vision

The Original Vision

When I started building Orpheus, I wanted to explore a fundamental question: **Can we build an AI coding assistant that truly understands the codebase it's working with?**

The vision was ambitious:

• Multi-model orchestration - Use the right model for each task (Claude for coding, Codex for review, Gemini for documentation)
• Persistent memory - Learn from successful refactoring patterns and reuse them
• **Workspace awar