Ordewell
github.com/ordewell/ordewell- Category
- AI Agents
- Rank
- No. 1174Tools index
Previous survey · No. 1160 ·
- Pricing
- Open Source
- Type
- AGENT
- Use case
- Agent Building
- GitHub
- 207 stars
- Latest release
- v0.11.1
- Date
About
Ordewell is multi-agent orchestration software that turns a single goal into an ordered, rewritable plan of coding-agent tasks, each assigned its own runner, model, and mode, then executes and verifies the results.
What it does
Ordewell sits between you and the coding agents you already run. You type a goal; a separate planner model reads the repository without changing it, asks questions, and proposes a list of tasks with dependencies, each pinned to Claude Code, Codex or OpenCode with its own model and effort level. Nothing starts until you approve. Approved tasks run in parallel on their own git branches, land one at a time on a run branch, and wait for you to merge.
Why it's ranked here
The safety claims live in the mechanism, not in prompts. A task counts as done only when its agent reports through a tool bound to that one attempt, so a stale or confused session cannot mark work finished. The planner's shell runs inside an operating-system sandbox on Linux and macOS, underneath a command classifier that already refuses writes. Design choices, including the options rejected, are written up as numbered decision records, and the code is Apache 2.0. For software that points several agents at your repository at once, that is where the engineering should go.
What's good
Plans are data you can change before spending anything on execution: move a task to another agent, swap its model or rewire its dependencies from the command line without asking the planner again. Each code-changing task gets its own worktree, and finished work lands one task at a time with a merge commit per task, so any task's changes can be traced. A conflicting merge is aborted with the work kept rather than failed. An optional supervisor can watch a run and, if you allow it, retry or stop tasks within limits. The planner can run on an agent subscription you already pay for, or on keys from 25 providers.
Tradeoffs
The sandbox has gaps the project documents itself. Windows gets none, and stock Ubuntu 24.04 blocks the unprivileged namespaces the Linux sandbox needs, leaving only the command classifier. On macOS a sandboxed command can still reach existing launchd jobs. The per-task access tokens separate roles but, by the project's own account, do not defend against a hostile process running as the same user. Uncommitted edits to tracked files switch off branch isolation for a run until you stash or opt out. On Windows the terminal interface needs WSL. The author also notes that a job one agent finishes in one context gains nothing from orchestration.
How to use it well
It fits a developer who already uses Claude Code, Codex or OpenCode, ideally more than one, and wants a multi-step change split up, reviewed as a plan, and run in parallel without agents editing the same checkout. Commit or stash before a run so isolation stays on. Use read-only tasks for reviews and audits, and keep the supervisor at Watch until you trust its edits. Install through npm or the editor extension; you need Node.js 20 or newer and git. Skip it for small single-file fixes, where one agent session costs less.
Technical notes+
The root package.json is a private npm workspaces monorepo (packages/core, packages/vscode, packages/cli, packages/web) built with tsup and TypeScript, Apache-2.0. packages/cli/src/main.ts opens the TUI on a bare invocation when stdin is a TTY, prints help otherwise, and turns a refused daemon connection into a readable error; commands reach a local daemon through ApiClient. packages/core/src/index.ts exports the shared core: TaskOrchestrator, Planner, createWorktreeIsolation, classifyCommand with AUTO_COMMANDS and REFUSED_COMMANDS, effect and planner allowlists, and ClaudeCodeAdapter, CodexAdapter and OpenCodeAdapter. docs/adr/isolation/0013-worktree-isolation.md specifies per-task worktrees under a git-ignored state directory, a per-run integration branch, a serialized git merge --no-ff queue ordered by plan order, and a block on dirty tracked files. docs/adr/planner-envelope/0011-sandboxing-the-planners-shell.md puts bubblewrap (Linux) or sandbox-exec (macOS) under the classifier, with only a per-session scratch directory writable and no network for auto-tier commands; Windows runs on the classifier alone. docs/adr/runners/0022-ordewell-mcp-server.md describes one loopback Streamable HTTP MCP server with per-attempt task tokens and per-conversation planner tokens; VerdictEngine is the only verdict producer and only a done status from task_complete passes. docs/adr/supervision/0029-the-supervisor.md defines Off, Watch (default) and Act levels, with every execution tool routed through one command seam. docs/why-a-separate-planner.md describes brace-aware JSON extraction and a single re-prompt when a plan fails to parse.
Observed
- License
- Apache-2.0; the name and logos are excluded and covered by a separate notice
- Language
- TypeScript, npm workspaces monorepo (core, vscode, cli, web)
- Install
- npm install -g ordewell; VS Code Marketplace and Open VSX extension that bundles its own core
- Interfaces
- Terminal UI, VS Code extension, CLI for scripts, local API, sharing one core
- Supported coding agents
- Claude Code, Codex and OpenCode, mixable within one plan
- Requirements
- Node.js 20 or newer, git for task isolation, at least one supported coding agent
- Platform support
- Linux and macOS; on Windows the terminal UI runs under WSL
- Planner shell sandbox
- bubblewrap on Linux, sandbox-exec on macOS, none on Windows
- Agent integration
- Loopback-only MCP server with per-attempt task tokens
- Design records
- Architecture decision records in the repository, including rejected options
Read from README.md, package.json, LICENSE, docs/why-a-separate-planner.md, packages/cli/src/main.ts, packages/core/src/index.ts, docs/adr/supervision/0029-the-supervisor.md, docs/adr/isolation/0013-worktree-isolation.md, docs/adr/planner-envelope/0011-sandboxing-the-planners-shell.md, docs/adr/runners/0022-ordewell-mcp-server.md.
Tags
Tech Stack
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.