Discovery
How Orcha finds your projects and knows what every session is doing.
Project Scanning
On launch, Orcha scans ~/.claude/projects/to discover every directory where you've used Claude Code. Each entry corresponds to a project path on your filesystem, and Orcha resolves these to build your project list. If you've run claudein a directory, Orcha knows about it — no manual setup.
Session Scanning
Session history lives in the same place: each project's directory under ~/.claude/projects/ holds the transcript of every session run there. This is what powers the all-sessions search in the Library— every session you've ever run, across every project, including ones started outside Orcha.
Live Status via Hooks
Knowing a session existsis different from knowing what it's doing right now. For live status, Orcha registers Claude Code's native hooks — when a session stops or asks for permission, Claude Code itself tells Orcha the moment it happens. No polling, no screen-scraping, no missed prompts.
Session Enrichment
After discovering sessions, Orcha enriches them by parsing the session transcripts in the background — message counts, token usage, and summaries. Sessions may show placeholder data for a few seconds after launch until enrichment completes.