APOHARA Framework

Agentic Pipeline Orchestration for High-performance Autonomous Research & Actions

A single-binary, Rust-native orchestration layer for Claude Code (and OpenCode): real MCP daemon, hooks that fire in-process, a true AFK mode (RALPH), and a context statusline — no Node/Bun/Ruby runtime for the core. Synthesized from the best ideas of superpowers, oh-my-claudecode, get-shit-done-redux and oh-my-opencode-slim, but with a native engine instead of a scripting layer.

Status: core implemented and tested — 93 tests, 0 warnings. Installed and verified live as a Claude Code plugin. Young project; see docs/V2-ROADMAP.md for what's next.

What works today

Capability	Command / how
Config — typed (serde) + ${ENV} expansion + cascade discovery	apohara check
Hooks in Rust via stdin — session-start (context), pre-tool (blocks dangerous commands), post-tool, notification, stop	apohara hook <event> (wired in hooks/hooks.json)
MCP daemon — spawns MCP servers, JSON-RPC over stdio, invokes their tools via IPC	apohara daemon, apohara call <server> <tool>, apohara status
RALPH mode (AFK) — persistent plan state + a stop gate that keeps the agent working until done	apohara ralph start/status/done/block
Statusline / HUD — context bar, cost, model	apohara statusline (wired in ~/.claude/settings.json)

Stubs (not implemented yet): run, shell, plan.

Quick start

As a CLI

cargo build --release
cargo test                       # 93 passed
./target/release/apohara version # apohara 1.0.0
./target/release/apohara check   # validate config

As a Claude Code plugin

./install.sh                                      # build + wire statusline (with backup)
claude plugin marketplace add "$PWD"
claude plugin install apohara@apohara-marketplace
# then: /reload-plugins (or restart)

Activates 5 hooks, the bundled MCP servers, 7 agents, and the /ralph /plan /review /debug /done commands. Full walkthrough: docs/TUTORIAL.md.

Architecture

src/
  config.rs        # typed config (serde), validation, env expansion, cascade discovery
  hooks/           # stdin JSON hooks: session_start, pre_tool, post_tool, notification, stop
  mcp/             # protocol.rs (JSON-RPC/MCP types) + client.rs (hand-rolled stdio client)
  daemon/          # spawn + orchestrate MCP servers + unix-socket IPC
  ralph/           # RALPH state machine (checkboxes, progress, reversibility rule)
  statusline.rs    # HUD renderer (reads statusLine stdin)
  main.rs          # CLI: version, check, hook, daemon, call, status, ralph, statusline
skills/   agents/   commands/   # plugin components (Markdown + YAML frontmatter)
hooks/hooks.json  .claude-plugin/{plugin,marketplace}.json
apohara.toml      # config (framework, [[mcp]], [hooks.pre_tool], [ralph])

Bundled

• Skills (12): ralph-mode, autonomous-execution, web-research, system-operations, verification, code-review, systematic-debugging, subagent-dispatch, brainstorming, writing-plans, git-worktrees, finishing-branch.
• Agents (7): ralph, architect, implementer, reviewer, debugger, researcher, ops.
• MCP servers: brave-search, tavily, filesystem, memory, github (web ones need API keys).

Docs

• docs/TUTORIAL.md — how to test everything, end to end.
• docs/V2-ROADMAP.md — current state + what's next.
• docs/HUD.md — the statusline.
• docs/superpowers/specs|plans/ — design specs and implementation plans (R1–R5).

Development

cargo build && cargo test && cargo clippy

Built with the brainstorm → spec → plan → TDD workflow; one cohesive phase (R1–R5) per spec/plan in docs/superpowers/.