# ralph-orchestrator

Podium publishes this catalog and sells an agent development environment. Podium chooses the products, criteria, sources and wording, so treat these pages as vendor-authored research. Check important claims against the linked primary sources. The same evidence rules apply to Podium and its competitors, but they do not remove this conflict of interest.

Page: https://adecomparison.com/ade/ralph-orchestrator/
Website: https://github.com/mikeyobrien/ralph-orchestrator
Research: covered

Method: https://adecomparison.com/method/

Rank by must-haves met, then preferences, then name. Read each finding's checked date. Findings stay published after their scheduled recheck. Checks over six months old may be outdated.

## ralph-orchestrator:ACC-01

Finding: Ralph supplies a native CLI/TUI on macOS, Linux and Windows plus an alpha browser dashboard and Telegram integration. It has no product-owned native phone app.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Documentation and pinned source inspection only; no hands-on scenario was run.
Other atomic questions remain unestablished: mobile_browser, editor_extensions, notifications, cross_device_continuity.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/installation.md
Locator: Prerequisites OS; installation methods
Finding: The first-party installation guide explicitly supports macOS, Linux and Windows for the native Ralph CLI. These are terminal clients rather than desktop GUI applications.
Retrieved: 2026-11-13

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/crates/ralph-cli/src/loops.rs
Locator: Loop launch, diff and publish-review operations; core event loop; web backend routes and database schema
Finding: Bounded inspection of the native loop and alpha web runtime found installed host CLI processes and Git-worktree separation, without product-managed container/VM provisioning, enterprise human SSO or named human team permissions. Hat roles are agent operational roles. publish-review pushes a branch and writes a Markdown handoff; it does not create or manage a pull request.
Retrieved: 2026-11-13

## ralph-orchestrator:ACC-02

Finding: Eleven named CLI backends and custom commands are documented, with different backends selectable per hat.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/backends.md
Locator: Supported Backends; Backend Setup; Per-Hat Backend Override
Finding: Names Claude Code, Codex, Gemini CLI, OpenCode and Pi among eleven backends, documents native Claude login and API keys, and per-hat backend overrides.
Retrieved: 2026-11-08

## ralph-orchestrator:ACC-03

Finding: Backend setup supports native Claude login and provider API credentials. Costs and account rights belong to the selected agent.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/backends.md
Locator: Supported Backends; Backend Setup; Per-Hat Backend Override
Finding: Names Claude Code, Codex, Gemini CLI, OpenCode and Pi among eleven backends, documents native Claude login and API keys, and per-hat backend overrides.
Retrieved: 2026-11-08

## ralph-orchestrator:ACC-04

Finding: Install Ralph and a supported agent CLI, initialize a backend, then plan or run. Dashboard setup additionally needs Rust and Node.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

## ralph-orchestrator:ACC-05

Finding: Ralph provides its CLI and a stdio MCP server scoped to one workspace.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/cli-reference.md
Locator: ralph run; loops; tools memory; tools task
Finding: CLI documents bounded iterations, headless execution, recording, continuation, loop logs/diff/rebase/resume, and memory/task operations.
Retrieved: 2026-11-08

## ralph-orchestrator:PLAN-01

Finding: Runtime tasks can be added, listed and inspected through product commands.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/cli-reference.md
Locator: ralph run; loops; tools memory; tools task
Finding: CLI documents bounded iterations, headless execution, recording, continuation, loop logs/diff/rebase/resume, and memory/task operations.
Retrieved: 2026-11-08

## ralph-orchestrator:PLAN-02

Finding: Interactive planning writes requirements, design and implementation-plan Markdown under .ralph/specs.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

## ralph-orchestrator:PLAN-04

Finding: Persistent Markdown memory is shared across parallel loops; tools can search, add and delete entries.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/cli-reference.md
Locator: ralph run; loops; tools memory; tools task
Finding: CLI documents bounded iterations, headless execution, recording, continuation, loop logs/diff/rebase/resume, and memory/task operations.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/advanced/parallel-loops.md
Locator: How It Works; Loop States; Auto-Merge Workflow; Remote Review Workflow
Finding: Concurrent loops have worktrees, separate events/tasks and shared memories. Completed work can enter a merge queue or publish remote review branches; failed merges need review.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/advanced/memory-system.md
Locator: Overview; Memory Types
Finding: Memories persist across sessions in .agent/memories.md and include codebase patterns, decisions and recurring solutions.
Retrieved: 2026-11-08

## ralph-orchestrator:PLAN-06

Finding: Ralph owns persistent runtime task records with ready, close and fail operations; a full issue backlog workflow is not established.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/cli-reference.md
Locator: ralph run; loops; tools memory; tools task
Finding: CLI documents bounded iterations, headless execution, recording, continuation, loop logs/diff/rebase/resume, and memory/task operations.
Retrieved: 2026-11-08

## ralph-orchestrator:PLAN-07

Finding: Runtime task commands are exposed to agents as tools.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/cli-reference.md
Locator: ralph run; loops; tools memory; tools task
Finding: CLI documents bounded iterations, headless execution, recording, continuation, loop logs/diff/rebase/resume, and memory/task operations.
Retrieved: 2026-11-08

## ralph-orchestrator:PLAN-08

Finding: Planning creates persistent requirements and design files; approval and drift gates remain unestablished.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

## ralph-orchestrator:COORD-01

Finding: Additional concurrent loops run in separate Git worktrees.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/advanced/parallel-loops.md
Locator: How It Works; Loop States; Auto-Merge Workflow; Remote Review Workflow
Finding: Concurrent loops have worktrees, separate events/tasks and shared memories. Completed work can enter a merge queue or publish remote review branches; failed merges need review.
Retrieved: 2026-11-08

## ralph-orchestrator:COORD-03

Finding: The shipped Hatless Ralph coordinator delegates work through named hat events, receives their event results and can route hats to different coding-agent backends with fresh iteration context.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Documentation and pinned source inspection only; no hands-on scenario was run.
Other atomic questions remain unestablished: results_return, activation, authentication, live_progress, retained_results, followup, invocation.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/backends.md
Locator: Supported Backends; Backend Setup; Per-Hat Backend Override
Finding: Names Claude Code, Codex, Gemini CLI, OpenCode and Pi among eleven backends, documents native Claude login and API keys, and per-hat backend overrides.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/crates/ralph-core/src/hatless_ralph.rs
Locator: HatlessRalph coordinator, HatInfo::event_publishing_guide and workflow_section; docs/guide/backends.md per-hat backends; event_loop/mod.rs
Finding: The product always supplies a Hatless Ralph coordinator role. Its shipped prompt instructs that coordinator to delegate through ralph emit events to named specialized hats, and event publishing starts a fresh iteration with clear context. Hats can select distinct coding-agent backends, publish results/events back into the product event loop and retain task/event state. This is product-supplied coordination, not merely display of provider-native subagents.
Retrieved: 2026-11-13

## ralph-orchestrator:COORD-04

Finding: The alpha legacy Node API can start agent work from externally created unblocked tasks through its owned dispatcher, without a human initiating each execution.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-01-12
Plan: Alpha legacy Node web backend, enabled with --legacy-node-api
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Documentation and pinned source inspection only; no hands-on scenario was run.
Other atomic questions remain unestablished: schedules, recurring_tasks, completion_conditions, overlaps, retries.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/backend/ralph-web-server/src/api/rest.ts
Locator: POST /api/v1/tasks autoExecute; serve.ts Dispatcher setup; runner/RalphTaskHandler.ts
Finding: The alpha legacy Node REST API is explicitly for external consumers. Creating an unblocked task auto-enqueues it unless autoExecute is false, and the product-owned Dispatcher executes it through RalphTaskHandler without a human click for each run. The backend service must remain running; no cron-schedule claim is established.
Retrieved: 2026-11-13

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Web Dashboard (Alpha); ralph web --legacy-node-api opt-in; Development commands
Finding: The first-party README explicitly labels the web dashboard Alpha, warns of breaking changes, and documents ralph web --legacy-node-api as the opt-in deprecated Node backend. The unattended task-dispatch path and operator-server mode inspected in that backend are publicly enableable experimental paths.
Retrieved: 2026-11-13

## ralph-orchestrator:COORD-05

Finding: Loops can be stopped/resumed; Telegram questions block until answered and proactive messages steer a run.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/cli-reference.md
Locator: ralph run; loops; tools memory; tools task
Finding: CLI documents bounded iterations, headless execution, recording, continuation, loop logs/diff/rebase/resume, and memory/task operations.
Retrieved: 2026-11-08

## ralph-orchestrator:COORD-07

Finding: Five built-in workflows and direct prompts are documented.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/backends.md
Locator: Supported Backends; Backend Setup; Per-Hat Backend Override
Finding: Names Claude Code, Codex, Gemini CLI, OpenCode and Pi among eleven backends, documents native Claude login and API keys, and per-hat backend overrides.
Retrieved: 2026-11-08

## ralph-orchestrator:RUN-01

Finding: Ralph normally invokes installed agent CLIs on the current host. Its documented alpha legacy Node web mode also supplies an operator-hosted network server with detached agent processes independent of browser clients.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Local CLI runtime; the operator-server path uses the alpha legacy Node backend with --legacy-node-api.
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Documentation and pinned source inspection only; no hands-on scenario was run.
Other atomic questions remain unestablished: self_hosted, hybrid, provisioning, payer, resources, region, expiry, other_device_continuation.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/backend/ralph-web-server/src/runner/ProcessSupervisor.ts
Locator: spawn detached and unref; api/server.ts host binding; README ralph web --legacy-node-api
Finding: The documented alpha web command can enable the legacy Node backend. That backend binds an operator-selected network host, starts detached native Ralph processes, persists PID/status/logs and can reconnect after server restarts. Agent work is owned by that server process tree rather than a browser connection. This is a self-hosted alpha mode; no managed Ralph cloud is supplied.
Retrieved: 2026-11-13

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/crates/ralph-cli/src/loops.rs
Locator: Loop launch, diff and publish-review operations; core event loop; web backend routes and database schema
Finding: Bounded inspection of the native loop and alpha web runtime found installed host CLI processes and Git-worktree separation, without product-managed container/VM provisioning, enterprise human SSO or named human team permissions. Hat roles are agent operational roles. publish-review pushes a branch and writes a Markdown handoff; it does not create or manage a pull request.
Retrieved: 2026-11-13

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Web Dashboard (Alpha); ralph web --legacy-node-api opt-in; Development commands
Finding: The first-party README explicitly labels the web dashboard Alpha, warns of breaking changes, and documents ralph web --legacy-node-api as the opt-in deprecated Node backend. The unattended task-dispatch path and operator-server mode inspected in that backend are publicly enableable experimental paths.
Retrieved: 2026-11-13

## ralph-orchestrator:RUN-02

Finding: Ralph separates parallel loop checkouts with Git worktrees and runs native host CLI processes; it provides no built-in container or VM isolation.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Documentation and pinned source inspection only; no hands-on scenario was run.
Other atomic questions remain unestablished: checkout, branch, os_sandbox, filesystem, process, network, secrets, security_boundary.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/advanced/parallel-loops.md
Locator: How It Works; Loop States; Auto-Merge Workflow; Remote Review Workflow
Finding: Concurrent loops have worktrees, separate events/tasks and shared memories. Completed work can enter a merge queue or publish remote review branches; failed merges need review.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/crates/ralph-cli/src/loops.rs
Locator: Loop launch, diff and publish-review operations; core event loop; web backend routes and database schema
Finding: Bounded inspection of the native loop and alpha web runtime found installed host CLI processes and Git-worktree separation, without product-managed container/VM provisioning, enterprise human SSO or named human team permissions. Hat roles are agent operational roles. publish-review pushes a branch and writes a Markdown handoff; it does not create or manage a pull request.
Retrieved: 2026-11-13

## ralph-orchestrator:RUN-03

Finding: Existing loop state can be continued and suspended loops resumed; no crash recovery experiment was run.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/cli-reference.md
Locator: ralph run; loops; tools memory; tools task
Finding: CLI documents bounded iterations, headless execution, recording, continuation, loop logs/diff/rebase/resume, and memory/task operations.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/advanced/parallel-loops.md
Locator: How It Works; Loop States; Auto-Merge Workflow; Remote Review Workflow
Finding: Concurrent loops have worktrees, separate events/tasks and shared memories. Completed work can enter a merge queue or publish remote review branches; failed merges need review.
Retrieved: 2026-11-08

## ralph-orchestrator:RUN-05

Finding: Current configuration bounds iterations and total runtime, with adapter inactivity timeouts and per-hat activation caps.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/configuration.md
Locator: Event Loop; adapters; hooks; hats
Finding: Configuration defines iteration/runtime limits, inactivity timeouts, hook timeouts and per-hat activation limits.
Retrieved: 2026-11-08

## ralph-orchestrator:RUN-06

Finding: Loop logs and event history expose operational state and JSONL export.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/cli-reference.md
Locator: ralph run; loops; tools memory; tools task
Finding: CLI documents bounded iterations, headless execution, recording, continuation, loop logs/diff/rebase/resume, and memory/task operations.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/advanced/parallel-loops.md
Locator: How It Works; Loop States; Auto-Merge Workflow; Remote Review Workflow
Finding: Concurrent loops have worktrees, separate events/tasks and shared memories. Completed work can enter a merge queue or publish remote review branches; failed merges need review.
Retrieved: 2026-11-08

## ralph-orchestrator:TEAM-01

Finding: The Telegram integration can route instructions from multiple humans reaching the bot into the same loop as human.guidance or human.response events.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Opt-in Telegram integration; RObot.enabled=true
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Documentation and pinned source inspection only; no hands-on scenario was run.
Other atomic questions remain unestablished: visibility, discussion, comments, presence, ordering, conflicts, permissions, plan_restrictions, owner_online.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/crates/ralph-telegram/src/service.rs
Locator: Telegram update polling and MessageHandler::handle_message; handler.rs human.guidance and human.response
Finding: The Telegram integration routes incoming human messages to the selected loop. The polling service passes message text and chat ID to the handler, which appends human.guidance or human.response events to that loop; messages are not restricted to one sender identity in the inspected handler path. Distinct humans can send messages from their separate Telegram accounts (including a shared group chat) to steer the same loop; they do not share an ADE owner bearer credential. Per-human attribution and team permissions are not supplied by this path.
Retrieved: 2026-11-13

## ralph-orchestrator:TEAM-02

Finding: The inspected Ralph runtime has agent hat roles and local/API control, without named human workspace roles or enterprise SSO.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Documentation and pinned source inspection only; no hands-on scenario was run.
Other atomic questions remain unestablished: project_roles, task_roles, membership, provisioning, unauthorized_access, revocation, plan_scope.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/crates/ralph-cli/src/loops.rs
Locator: Loop launch, diff and publish-review operations; core event loop; web backend routes and database schema
Finding: Bounded inspection of the native loop and alpha web runtime found installed host CLI processes and Git-worktree separation, without product-managed container/VM provisioning, enterprise human SSO or named human team permissions. Hat roles are agent operational roles. publish-review pushes a branch and writes a Markdown handoff; it does not create or manage a pull request.
Retrieved: 2026-11-13

## ralph-orchestrator:SHIP-01

Finding: Planning documents and branch diffs can be retained, and publish-review writes a Markdown handoff.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/advanced/parallel-loops.md
Locator: How It Works; Loop States; Auto-Merge Workflow; Remote Review Workflow
Finding: Concurrent loops have worktrees, separate events/tasks and shared memories. Completed work can enter a merge queue or publish remote review branches; failed merges need review.
Retrieved: 2026-11-08

## ralph-orchestrator:SHIP-02

Finding: Backpressure workflows request test, lint and typecheck evidence; instruction examples do not prove that an external verifier enforced it.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/concepts/backpressure.md
Locator: In Hat Instructions; Implementing Backpressure; Anti-Patterns
Finding: Documents test/lint/typecheck evidence and reviewer hats, but warns that emitted evidence can be fake. Instructional examples are not proof of enforcement.
Retrieved: 2026-11-08

## ralph-orchestrator:SHIP-03

Finding: Ralph integrates worktree diff, branch publish/rebase and merge operations; publish-review writes a Markdown handoff and pushes the branch without creating a pull request.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Documentation and pinned source inspection only; no hands-on scenario was run.
Other atomic questions remain unestablished: branches, commits, comments, ci_response, product_state.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/advanced/parallel-loops.md
Locator: How It Works; Loop States; Auto-Merge Workflow; Remote Review Workflow
Finding: Concurrent loops have worktrees, separate events/tasks and shared memories. Completed work can enter a merge queue or publish remote review branches; failed merges need review.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/crates/ralph-cli/src/loops.rs
Locator: Loop launch, diff and publish-review operations; core event loop; web backend routes and database schema
Finding: Bounded inspection of the native loop and alpha web runtime found installed host CLI processes and Git-worktree separation, without product-managed container/VM provisioning, enterprise human SSO or named human team permissions. Hat roles are agent operational roles. publish-review pushes a branch and writes a Markdown handoff; it does not create or manage a pull request.
Retrieved: 2026-11-13

## ralph-orchestrator:SHIP-04

Finding: Optional auto-merge uses merger, resolver and tester hats. Exact-revision authorization is unestablished.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/advanced/parallel-loops.md
Locator: How It Works; Loop States; Auto-Merge Workflow; Remote Review Workflow
Finding: Concurrent loops have worktrees, separate events/tasks and shared memories. Completed work can enter a merge queue or publish remote review branches; failed merges need review.
Retrieved: 2026-11-08

## ralph-orchestrator:OWN-01

Finding: Ralph application source is MIT licensed.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/LICENSE
Locator: MIT License grant
Finding: The repository grants the application source under MIT.
Retrieved: 2026-11-08

## ralph-orchestrator:OWN-02

Finding: The core Ralph CLI and local web stack can run on user-controlled hardware.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/cli-reference.md
Locator: ralph run; loops; tools memory; tools task
Finding: CLI documents bounded iterations, headless execution, recording, continuation, loop logs/diff/rebase/resume, and memory/task operations.
Retrieved: 2026-11-08

## ralph-orchestrator:OWN-03

Finding: Ralph provides opt-in local diagnostic output controlled by RALPH_DIAGNOSTICS; leaving it unset disables those collectors. Coding-agent/provider telemetry is separate.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Documentation and pinned source inspection only; no hands-on scenario was run.
Other atomic questions remain unestablished: code_data, prompts, credentials, logs, artifacts, retention, deletion, training, residency, subprocessors, consent_prompt, provider_separation.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/crates/ralph-core/src/diagnostics/mod.rs
Locator: DiagnosticsCollector::new and RALPH_DIAGNOSTICS environment flag
Finding: Ralph diagnostic collection is opt-in through RALPH_DIAGNOSTICS=1. When unset or another value, the collector creates no diagnostic directory or loggers. It controls local agent output, traces, hook-run telemetry and performance JSONL files; provider telemetry is separate.
Retrieved: 2026-11-13

## ralph-orchestrator:OWN-04

Finding: Ralph is free MIT software without a published paid Ralph plan. Its supported backend setup accepts the user provider API keys or native CLI logins, billed separately.

Verification: sourced
Checked: 2026-11-10
Scheduled recheck: 2026-11-24
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: First-party pricing sources read 2026-11-10

Documentation and pinned source inspection only; no hands-on scenario was run.
Other atomic questions remain unestablished: currency, interval, seats, seat_minimum, workspace_fees, included_usage, credits, trial, overages, taxes, compute_cost.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/main/README.md
Locator: Quick start (ralph init --backend); 'License'
Finding: Says the tool is MIT licensed and runs on a backend agent you choose, such as Claude. It mentions no paid plan or price.
Retrieved: 2026-11-10

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/main/LICENSE
Locator: Permission grant, first paragraph
Finding: The MIT License lets anyone obtain, use, copy and modify the software free of charge.
Retrieved: 2026-11-10

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/docs/guide/backends.md
Locator: Backend setup and auth environment variables
Finding: The first-party backend setup explicitly accepts user provider API credentials, including ANTHROPIC_API_KEY and GEMINI_API_KEY, as well as native CLI logins. Model usage is billed by the selected provider, separately from the free Ralph software.
Retrieved: 2026-11-13

## ralph-orchestrator:OWN-06

Finding: The latest listed release is 2.10.1, published June 23; current README labels the browser dashboard alpha.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-11-22
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Only the named facts are documented. Unanswered atomic questions remain unknown; no execution test was performed.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md
Locator: Quick Start; Web Dashboard; MCP; RObot; FAQ
Finding: Ralph offers CLI/TUI loops, an alpha web dashboard, workspace-scoped MCP server, planning documents, backend selection and Telegram intervention.
Retrieved: 2026-11-08

Source: https://github.com/mikeyobrien/ralph-orchestrator/releases/tag/v2.10.1
Locator: Release date and release notes
Finding: 2.10.1 - 2026-06-22 was published 2026-06-23. Release notes describe the scoped changes; this is not a hands-on check.
Retrieved: 2026-11-08

## ralph-orchestrator:OWN-08

Finding: Ralph Orchestrator is a free MIT download from npm, Cargo or the GitHub Releases installer, with no paid plan shown; optional sponsorship is a donation. Agent and model costs are paid to their providers.

Verification: agent-cross-checked
Checked: 2026-11-10
Scheduled recheck: 2026-11-24
Plan: Not specified
Surface: Ralph CLI, TUI and alpha web dashboard
Version: Source documentation at 64040fd0cda4d83386e4d1d1aa65571dadfe00b3

Free scenarios, usage caps and card requirements for the underlying agents were not checked. No installed-product test was run.

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/LICENSE#L1-L3
Locator: LICENSE lines 1-3, commit 64040fd
Finding: The repository is MIT licensed, copyright Ralph Orchestrator Contributors.
Retrieved: 2026-11-10

Source: https://github.com/mikeyobrien/ralph-orchestrator/blob/64040fd0cda4d83386e4d1d1aa65571dadfe00b3/README.md#L19-L40
Locator: README.md Installation section lines 19-40, commit 64040fd
Finding: Ralph installs free from npm (@ralph-orchestrator/ralph-cli), a GitHub Releases installer script or cargo install ralph-cli; the README names no price, account or paid plan. FUNDING.md asks only for optional GitHub Sponsors donations.
Retrieved: 2026-11-10