OmniHarnessRun locally
Agentic supervisor harness for CLI agents

Keep your coding agent working 24/7 and control it remotely

OmniHarness is the manager for your coding CLI that makes sure your plan is fully implemented and your agent is working 24/7. Control Codex, Claude, Gemini, OpenCode, and any ACP-compatible worker.

omniharness.devlocal runtime online
active run
worker-launch-and-inspector
12m 44s patch stream

supervisor created implementation conversation

codex reading plan and repository state

event tool_call: rg src/server/supervisor

worker patch ready, tests queued

Codexplanning
Claudepatching
Geminireviewing
OpenCodeidle
web UICLI parityACP server modeSQLite historylocal PWA

Supervisor Layer

Stop babysitting terminals. Inspect the whole run.

01

One supervisor for many CLI agents

Start implementation, planning, or direct-control runs across ACP workers without losing the thread between terminals.

02

Live execution you can actually inspect

Messages, worker output, execution events, status changes, retries, and recoverable state stay visible while the run is moving.

03

Durable local memory

Runs, messages, workers, settings, auth records, and execution events persist in SQLite for recovery and later forensics.

Web UI
OmniHarness runtimeevents, workers, recovery, auth, settings
ACP workers

Architecture

Web, CLI, and ACP clients meet the same durable supervisor.

OmniHarness keeps orchestration local, observable, and scriptable. Use the UI when you want a cockpit, the CLI when you want speed, and ACP mode when another client should delegate through the harness itself.

Implementation

omni --mode implementationHand a plan to a worker and watch the patch, output, and recovery state.

Planning

omni --mode planningAsk a CLI agent to shape a plan while the supervisor records the conversation.

Direct

omni --mode directDrive an agent interactively when you need quick inspection or careful steering.

Quick Start

Three commands from checkout to supervised agents.

OmniHarness is built as a local Next.js app with an in-repo runtime. The public site should feel polished, but the product stays practical: clone, install with pnpm, check adapters, then run.

1
pnpm install

Install the local web app, runtime, and CLI dependencies.

2
pnpm setup:agents

Check Codex, Claude, Gemini, OpenCode, ACP adapters, and tool paths.

3
pnpm dev

Start the supervisor UI on :3050 and the managed runtime on :7800.

Trust Surface

Built for local machines, real repositories, and recoverable work.

Web UI, CLI, and ACP server mode share the same run model.
Managed worker PATH keeps agents useful when launched from GUI or service processes.
Phone-friendly PWA mode lets you supervise local work away from the keyboard.
Doctor endpoints expose adapter availability, API key state, and tool diagnostics.

Give every CLI agent a supervisor with memory.