Profile
Back to NewsBack
GitHub Trending 16 min
Reader Mode
dmae97/omk: Evidence-gated runner for Codex, Claude Code, OpenCode, and local coding agents. Routes tasks into scoped DAG lanes with replayable artifacts.

dmae97/omk: Evidence-gated runner for Codex, Claude Code, OpenCode, and local coding agents. Routes tasks into scoped DAG lanes with replayable artifacts.

7 hours ago

OMK, Open Multi-Agent Kit. Scope the work. Route the right agents. Verify every release. The mark shows a four-stage control loop with three routed lanes.

OMK

Open Multi-Agent Kit
Scope the work. Route the right agents. Verify every release.

A terminal coding agent that lets you switch models without starting a new session.

npm version npm downloads per month
latest GitHub release
MIT license supported Node.js version

Quick start · Default or opt-in? · Evidence and limits
Choosing OMK · Documentation


Why OMK

Choose a model, work on your repository, then switch models with /model when another one suits the next step. The conversation stays in the same session. You can also stop and return later with /resume or omk -c.

OMK is a standalone CLI, not a plugin for Claude Code or OpenCode. It supports subscription providers, API keys, and local models. Start with one agent that reads files, edits code, and runs commands. Add subagents or explicit verification workflows when you need them; neither is required for your first task.

Quick start

Requires Node.js 22.19 or newer. Start in the repository you want to work on:

npm install -g open-multi-agent-kit --ignore-scripts
omk --version
cd your-project
omk

Without a global install, run npx --ignore-scripts open-multi-agent-kit from that directory.

  1. Run /login to authenticate a supported subscription or API-key provider.
  2. Run /model to choose an available model.
  3. Try a read-only first task:
Summarize this repository and identify the commands used to check it.
Read the project configuration to support your answer. Do not edit files.

After the reply, use /model to choose another configured model and ask it to review the answer. You stay in the same session. This is manual model switching, not parallel agents or an independent correctness check.

For a bug fix, name the failing behavior and ask for a regression test, the smallest fix, and the check commands with their exit codes. Review the diff and those results yourself; a request to run tests does not enable a verification gate.

Built-in local bash requires sandbox-exec on macOS or bwrap plus unprivileged user namespaces on Linux. It blocks network access and fails closed if the backend is missing. See the safety boundary and full quickstart for setup.

What runs by default

A fresh install starts one agent/tool loop after provider setup. It does not turn each prompt into a multi-agent workflow or automatically certify its answer.

| Capability | Fresh-install behavior | Where to start | | --- | --- | --- | | File editing, shell commands, saved sessions | Built in; tools run when called by the agent | Usage, sessions | | Tool-call scheduling | dag-v2 schedules resource conflicts within the agent loop; it does not launch a team | Runtime algorithms | | Subagents | Optional extension; load it and supply agent definitions | Subagent setup and examples | | MCP servers, extra skills and extensions | Require configured servers or installed resources | MCP, skills, extensions | | Protocol verification and advisory judging | Explicit API/workflow opt-in; not a gate on ordinary prompts | Run protocol | | Context budgeting | Off by default | Settings | | AdaptOrch integration | Optional and separate; no service calls by default | OMK + AdaptOrch |

The internal lane launcher and automatic command-sharding primitives are not connected to the default CLI path. Installing their packages is not the same as enabling an orchestration workflow.

Evidence and limits

No comparative benchmark result is published here yet. We have not established that OMK solves more tasks than another harness, that multi-agent execution improves success, or how much verification reduces false completion.

OMK targets state-of-the-art quality as a CLI coding-agent harness. SOTA is not verified.

The evidence you can inspect today covers specific failure modes:

| Behavior covered | Regression evidence | Scope | | --- | --- | --- | | Missing test observations produce inconclusive; a required failing test produces fail | Protocol tests | Explicit protocol evaluation, without a waiver | | Changed artifacts, wrong command bindings, or missing ledger evidence block acceptance | Evidence binding tests | Strict evidence gate and selected workspace scope | | A relevant workspace mutation after verification makes the receipt stale | Freshness tests | Configured receipt and mutation tracking |

These tests exercise the gates, not the rate at which they catch real bugs. An ordinary prompt finishes when its tool loop and queued work settle; prompt_settled is not a correctness verdict.

A useful comparison must hold the model, provider configuration, tasks, budget, and tool permissions constant, and label default versus opt-in workflows. Report task success, cost, latency, and false completion (reported complete but failing the declared checks), with its denominator and per-task outcomes. The measurement protocol defines the reproducibility and privacy requirements. omk stats shows local turn costs and tool failures; it does not score task correctness.

If you evaluate OMK, share a sanitized report and reproduction steps in a GitHub issue. Include failed and interrupted runs, not just successful examples.

OMK//CONTROL

The terminal UI shows the selected model, tools, and session status. Additional signals depend on the integrations you configure.

OMK//CONTROL terminal dashboard showing model routing, tools, and session status

The header reads omk v · OMK//CONTROL; the installed package version is the source of truth.

Control loop

How scope, routing, verification, and replay fit together

OMK's provider-neutral coding-agent CLI also exposes a multi-agent control plane for explicitly configured workflows. The diagram describes that design, not what every prompt automatically runs.

Animated OMK control loop showing Scope, Route, Verify, and Replay

The v0.98.3 SDK rejects incomplete first-party judge responses and exposes deterministic ties; it is not an automatic TUI judge.

  1. Scope the goal, paths, resources, and acceptance predicates. A selected
orchestration workflow may also supply a DAG; an ordinary prompt remains one agent/tool loop.
  1. Route work to models, agent skills, MCP tools, and extensions without
changing the evidence contract.
  1. Verify declared checks in explicit evidence workflows. Required failing
checks block those workflows; advisory judging cannot replace them.
  1. Preserve receipts and replay state for bounded session recovery; continue
durable goals from explicit reducer state.

The animation changes once every 1.5 seconds and contains no flashing. The four steps above are the complete text alternative.

Verification boundary

AgentSession built-in local bash uses OS sandbox enforcement by default: sandbox-exec on macOS and bwrap plus unprivileged user namespaces on Linux. Local shell spawns restrict writes to the workspace and OS temporary directory, disable network access, and fail closed with sandbox.backend_missing when an enforcement backend is unavailable.

This is not read-confidentiality or whole-process containment. Other file tools, extension and custom-tool code, injected or remote BashOperations, and the OMK process keep the permissions of the process running them. Use containerization when the boundary must cover more than built-in local bash. Explicit evidence workflows cannot treat missing required evidence as a verified result.

Providers

Provider integrations and published packages

OMK keeps routing separate from control and evidence. Codex, Claude Code, OpenCode Zen/Go, Kimi, GLM/ZAI, native xAI/Grok, NVIDIA NIM, and local providers can participate through omk-ai while the run contract stays stable.

Native xai keeps subscription OAuth and XAI_API_KEY billing separate. See provider setup, provider resilience, and Grok integration.

Published packages

| Package | Purpose | | --- | --- | | open-multi-agent-kit | Interactive coding-agent CLI and control plane | | omk-agent-core | Agent runtime, tool execution, and DAG scheduling | | omk-ai | Unified multi-provider LLM API | | omk-protocol | Versioned run contracts and semantic reducers | | omk-adaptorch-wpl | Work Packet Loop runtime | | omk-book-to-skill | Optional document-to-skill compiler | | omk-tui | Differential-rendered terminal UI library |

npm install omk-agent-core
npm install omk-ai
npm install omk-protocol
omk install npm:[email protected]
npm install omk-tui

Repository understanding

Optional indexes, retrieval settings, and trust limits

v0.97.0 shipped the OpenWiki policy and workflow, but no versioned corpus or integrity checker. The following integrity/output guards shipped in v0.98.0; the generated corpus remains optional and is not bundled:

  • openwiki/ — absent. The previous untracked corpus was removed after the
hardened gate proved it carried fabricated evidence: 8 frontmatter symbols that no declared source path defines (AgentLoop, getModel, DeepWall, loadExtensions, createExtensionRuntime, main), 45 references to @omk/* package names this repository does not publish, and a restatement of this README's Scope -> Route -> Verify -> Replay loop as a strict engine state machine, which is not what the source implements. CI regenerates the corpus; nothing is lost.
  • scripts/check-openwiki.mjs — shipped integrity checker. An interrupted corpus
now fails unless openwiki/.manual-review.json binds a review to the exact corpus digest, and every frontmatter symbol must bind to one of that page's own source_paths as a whole identifier.
  • scripts/check-openwiki-output.mjs — output gate. The scheduled workflow
may write, upload, and open a PR for openwiki/ and nothing else, so a model reading this repository cannot reach AGENTS.md, CLAUDE.md, or the workflow that runs it. The gate runs once before the artifact leaves the read-only generating job and again before the PR, because the publishing job holds write permissions the first one does not.
  • .understand-anything/ — optional local structural graph used by Pi Lens;
it is not published or injected into prompts by default. To reach a session, attach it through OMK's MCP client like any other server; there is no second, bespoke path for it.

Source and tests remain authoritative. Shipped guards do not turn a generated index into authority: treat corpus pages as local advisory data and recheck source.

Retrieval

A corpus no session can read is documentation of a plan, not a feature, so the pages are now candidates for prompt budgeting. Enable contextBudget.openwiki alongside contextBudget.enabled (settings) and each page becomes a low-priority evidence item ranked against the turn's query. Pages compete for leftover budget and can never displace instructions or skills; most turns carry titles and declared symbols alone, and a page's text arrives only when the query earns it.

Admission mirrors scripts/check-openwiki.mjs rather than restating it. A complete corpus at the current HEAD offers page text; one whose HEAD has moved offers titles only and is marked stale; an interrupted corpus is refused unless a review binds to its exact digest. The default is off, and with the setting off the prompt is byte-identical to one built without a corpus.

OMK + AdaptOrch

OMK writes and runs code. AdaptOrch checks what it wrote. correctness_claim: false — it ran, and this is what happened.

OMK is this local, MIT-licensed coding agent. AdaptOrch is a separate proprietary evidence service. Neither requires the other: installing OMK does not create an AdaptOrch account or make calls to it by default.

For an optional integration, see the WPL package and clients and MCP setup. The WPL package exposes state, client, and adjudication primitives, not an automatic verification loop for every CLI prompt.

AdaptOrch's reports carry correctness_claim=false; they are not semantic correctness proofs or OMK harness benchmark results. Review AdaptOrch plans · Claim boundary

The AdaptOrch name and marks identify that separate proprietary product and appear here with permission. They are excluded from this repository's MIT grant — see LICENSE.

Prior art

Research references, not OMK benchmark results

The design decisions behind OMK's context, routing, memory, and orchestration layers are grounded in published work rather than invented in isolation. Each row below was retrieved and read directly; claims are at abstract level, which is the evidence grade this table asserts and no more.

| Paper | Mechanism it establishes | OMK implementation or design reference | | --- | --- | --- | | arXiv:2608.22752The Compaction Cliff in Long-Running AI Agent Memory | Uniform summarization erodes rules and episodic logs at the same rate; measured safety-rule retention falls to 53% after one compaction and 10% after five. Type-tagged deterministic operators fix it. | Type-aware compaction triage: rule-typed items survive N rounds byte-identical | | arXiv:2608.23023Most of the LLM Routing Gap Is Task Type | Most routing gain is reachable with a fixed task-type table; run-to-run flips must not be credited as wins. | Frozen task-class table plus the 2-run stability rule in the promotion gate | | arXiv:2506.16655Arch-Router: Aligning LLM Routing with Human Preferences | Indirection: a classifier emits a label, a policy table maps label to decision, so models change without retraining. | classifyTaskV4 plus TASK_CLASS_THINKING_LEVELS | | arXiv:2605.09894Deterministic vs. LLM-Controlled Orchestration | Holding model, prompts, and tools constant and varying only execution control, deterministic orchestration matched accuracy, improved worst-case robustness, and cut tokens up to 3.5x. | Deterministic scheduler and planned lanes; execution control is never delegated to the model | | arXiv:2608.15565Admission Without Answers | Label-free admission on execution success alone admits substantial contamination; an accept/abstain/escalate decision is required. | Verified-memory admission design (spec 019), abstain is not stored | | arXiv:2608.23471InjecMEM: Memory Injection Attack on LLM Agent Memory Systems | Single-interaction memory injection is a reproduced attack frame against agent memory. | Retrieved memory is injected only as provenance-tagged data, never fused into instruction position |

Entries include implemented mechanisms and design proposals; check the runtime status guide for availability. The wider survey, including approaches not adopted, is working material that is not published with the repository.

Documentation

Development

npm ci --ignore-scripts
npm run build
npm run check
npm test
npm run release:local

Direct dependencies are pinned, CI installs with --ignore-scripts, and the published CLI includes a generated npm-shrinkwrap.json. Read CONTRIBUTING.md and the development guide before sending a change.

FAQ

Why use OMK instead of Claude Code?

Use it for provider choice within one CLI session, or to build workflows against its public runtime and evidence APIs. For a single-provider workflow, your current agent may be sufficient. Try the read-only task above before moving existing work.

How is this different from OpenCode with plugins?

OMK is a separate runtime with its own CLI, sessions, tool scheduler, and SDK. One reason to choose it is to build your own acceptance workflow: define required test observations in the run protocol, then have your automation reject fail or inconclusive results. Receipt integrity and freshness still need their own configured checks.

For adding a tool or prompt to an existing OpenCode setup, a plugin may be the smaller change. OMK's protocol is opt-in, not proof of better performance.

Does multi-agent mean better results or automatic verification?

Not automatically. Subagents require setup, and verification must be part of the chosen workflow. Its result covers the declared checks, not all behavior. See what runs by default and evidence and limits.

Recent releases

Release notes and historical corrections

Historical correction: the immutable v0.97.0 notes below announced a
versioned OpenWiki corpus, but that release still ignored /openwiki/ and did
not contain the corpus or checker. See the current repository-understanding
section above for the shipped guards and optional-corpus boundary.

Release v0.98.5

Added

  • Added /debug runtime inspection, explicit metadata-only local reports with /debug save, and structured failure cards with expandable details. UI entry observations do not infer build revisions or authorize retries.
  • Added opt-in verified-run CLI/SDK paths with protected verification, immutable candidate recovery, input-checkpoint writer restart, and static DAG task retry. These paths retain approval, ownership and budget boundaries; they do not apply artifacts to the original workspace automatically.

Fixed

  • Strengthened execution ownership and shared-budget boundaries. Pre-commit checks preserve the selected index, including partially staged files, instead of expanding the commit.
  • Execution-ownership wrappers retain lazy, context-sensitive tool timeouts and stale-context rejection instead of fixing the timeout at registration.
Release notes live in RELEASE_NOTES_v0.98.5.md.

Release v0.98.4

New Features

  • DeepSeek V4.1 Flash on four existing providers with off/low/high/max thinking; see catalog details.
  • Opt-in CLI/SDK model dispatch contracts; see contract scope.
  • Bounded claim-repair explanations and stronger metrics/policy boundaries; see review evidence.

Added

  • Added --model-contract and SDK contract options, including first-party summaries through the shared provider stream. These are not universal billing or endpoint attestations.
  • Added Muse Code login/native Meta models, explicit provider synchronization and context-initialization workflows, active-skill state/selection, and improved MCP startup diagnostics.
  • Added offline TB subset selection and recorded-result audit utilities. They do not resume a benchmark or prove comparative harness gains.
  • Added optional AdaptOrch service links; displaying links does not create an account, upload source, or start a run.

Fixed

  • New metrics records use schema v2, explicit field projection and bounded error classes instead of raw error text. Valid v1 records remain readable; old files are not scrubbed automatically.
  • Empty, sparse or mutated gate lists cannot bypass merge validation. Sandbox overrides cannot silently weaken enforcement or expand the filesystem root without explicit trusted broadening.
  • Shared-DAG repair explanations retain shared repairs and local counterexamples, report bounded-search fallback as not-proven, and offer opt-in explicit witness groups. Neither explanations nor group labels authorize execution.
  • Model-contract denials are configuration failures. Text and JSON print modes return nonzero on final prompt failure rather than silently reporting success.
  • Improved compaction overflow guards, active-skill bookkeeping, provider resilience/usage handling, and login-provider resolution.
  • Reject non-finite tokenizer results, fall back for non-finite token estimates, and keep optional-context sorting a total order. Domain routing now treats repeated whitespace and line breaks consistently.
  • Preserve recognized environment references, placeholders and nearby type declarations during credential redaction without exempting literal credentials. Forced persistence/report redaction remains active regardless of input opt-out switches.
  • Improved clipboard-image handling on WSL and terminal file-link rendering, including safe link destinations and malformed MCP tool-schema handling.

Changed

  • Split type, schema and rendering responsibilities to restore module-size gates without raising their baselines. Browser smoke builds no longer require a Node path polyfill for Codex metadata.
Release notes live in RELEASE_NOTES_v0.98.4.md.

Release v0.98.3

Added

  • Advisory-selection diagnostics now retain submitted/eligible/excluded counts, comparison availability, and top-score tie/margin data. Ties preserve caller rank while reporting judge-tied / deterministic; no correctness probability or default TUI judge is introduced.
  • Claim-closure-to-WPL/VERA projection is tested across the public protocol and integration packages. It classifies supplied evidence and never grants release authority.
  • A session workspace scope now reports what it could not bind. resolveSessionWorkspaceScope() drops dirty paths two ways — a 32-path cap and the normalized-path filter the receipt parser forces — and both were silent, so a receipt captured from a partial view of the working tree read exactly like one that saw all of it. The new resolveSessionWorkspaceScopeReport(cwd, options?) returns the same scope plus totalDirtyPathCount, selectedPathCount, excludedPathCount, truncated, a completeness of complete / partial_truncated / partial_excluded / unavailable, and an excludedPathSetSha256 binding the dropped set. SessionBashRuntime.workspaceScopeReport() exposes it for the current session. unavailable is deliberately not complete: outside a worktree nothing was enumerated, so an empty artifact set is an absence of evidence rather than a clean tree. Dropping paths stays deliberate; hiding the drop was the defect. The scope cache is now keyed by (cwd, maxPaths) so a capped probe cannot serve a later full request its truncated answer.

Fixed

  • The first-party advisory model adapter now requires an explicit normal stop; complete score JSON from a truncated, aborted or missing completion state cannot override deterministic fallback. Cancellation before and after custom/model judge work prevents new calls and discards late advice, without additional completion calls or retries.
  • Release documentation now separates internal trace/effect primitives from public opt-in APIs and records the existing CI token-authentication path without claiming OIDC provenance. The published v0.98.2 history is retained as an ancestor rather than re-created.
Release notes live in RELEASE_NOTES_v0.98.3.md.

Acknowledgments

OMK builds on pi — Mario Zechner's MIT-licensed coding-agent harness — and began from the oh-my-pi fork. The vendored tree was removed in this release line; OMK 0.9x is OMK-native (see specs/constitution.md), and the design debt to both projects stands. Thank you.

License

MIT

Chat with me