orra

Orra

Directive & intelligence layer over Claude Code's Agents View.

🌐 Live site · Star on GitHub · npm

You: (just open Claude Code)

Orra: Morning. Yesterday's first move was: pick back up on JWT refresh.
      Today's situation:
      • Due today: AUTH-142 (in_progress, worktree auth-refactor)
      • Ready to land: billing-fix — PR approved, mergeable
      • Needs attention: onboarding — blocked (claude attach abc1234f)
      Recommended first action: triage onboarding (30s), then JWT.
      What's your plan for today?

You: focus is JWT, ship by 4pm.

Orra: Got it. I'll align suggestions to that. Spawning a background
      agent to rebase the 2 stale worktrees while you work — they'll
      be ready when you come back to them.

Orra is the standing orchestrator — the directive/intelligence/memory layer that rides on Claude Code's Agents View. The Agents View tells you "row 3 is waiting." Orra reads what row 3 is waiting on, runs a directive to handle it, keeps the memory layer, and reports a condensed picture.

What it is

Orra is not a worktree manager or a process supervisor — Claude Code's Agents View handles that. Orra is the layer on top: morning briefing, a heartbeat-driven directive pack, the .orra/memory/ layer, PR shepherding, Linear deadline tracking, and per-worktree cost tracking. It runs as a persistent claude --bg background agent so the heartbeat never needs re-arming.

Requires Claude Code ≥ 2.1.x with the Agents View enabled.

Three capabilities:

• Awareness — orra_scan joins the daemon roster ($CLAUDE_CONFIG_DIR/jobs/) with git worktree list, PR data, and custom providers. Classifies status (ready_to_land, needs_attention, in_progress, idle, stale) and pre-computes per-agent summaries so you never re-parse transcripts.
• Learning — a markdown memory layer under .orra/memory/. Daily notes, commitments, per-worktree notes, and weekly retros persist across sessions. Directives like morning-briefing and shutdown-ritual maintain it for you.
• Coordination — orra_spawn wraps claude --bg; spawned sessions appear in claude agents. orra_kill calls claude stop/claude rm. Blocked agents surface as needs_attention with a claude attach <id> hint.

Architecture