@moedex/cli
v0.2.0-beta.1
Published
moe: the Moedex command line
Readme
@moedex/cli
moe -- a local-first work and evidence kernel. Models propose work, validated operations change
state, and a task completes only when a passing check exists at the tree revision the attempt finished
on. A confident model response never substitutes for a check that actually ran.
Status: 0.2 beta. The rewrite (slices S1-S9) is feature-complete and gated end to end, but this is an early public release and interfaces may still move. Issues and feedback: https://github.com/moedex/moe
Not a plugin. This package installs the moe binary; host skills and MCP servers are generated into
agent hosts by moe install -- moe is not itself a host plugin.
Requirements
- Node.js >= 24. The CLI ships as a single self-contained bundle on the built-in
node:sqlite, so there are no native modules to compile and no dependencies to install. - Host workers need one or more of OpenCode, Codex, or Claude Code on your PATH.
- The local inference lane needs Ollama with a local model (optional for the core task/check/evidence loop).
Run moe doctor at any time to see what is present and what to install.
Install
npm install -g @moedex/cli
moe doctorThe core loop
moe workspace init
moe task add --title "Fix rounding" --acceptance test
moe attempt start <task-id>
moe check run --attempt <attempt-id> --kind test -- pnpm test
moe attempt finish <attempt-id> --outcome succeededcheck run executes the command itself and records the result; the model never writes evidence. A task
completes only when a passing check exists at the tree revision the attempt finished on.
State lives under $MOE_DATA_HOME (default ~/.local/share/moe/workspaces/<id>/). Moe writes nothing
into the repository at runtime.
What is in the box
Moe is one binary over a set of capability families:
- Work and evidence -- tasks, attempts, checks, recorded evidence, exit-coded results.
- Durable work -- plans and DAGs, a backlog, leases, budgets, and portable checkpoints
(
checkpoint export|import,work cancel|resume,work status). - Host workers -- supervised, protocol-first worker processes on OpenCode, Codex, and Claude Code,
settled by verified process identity (
worker launch|send|status|events|stop). There is no daemon. - Memory -- transcript and journal ingest with always-available lexical recall (and optional local
embeddings), exposed to hosts as the
moe-memoryMCP server (memory sync|index|search|show|doctor). - Browser and QA -- an owned acceptance browser plus a CDP-attach adapter, with a frozen, content-addressed QA evidence bundle.
- Inspection and economics -- exact-integer cost estimates, a local loopback
inspect serveread UI, and static offline reports. - Experiments and evaluation --
moe eval runwith versioned graders and honest reporting over a fixed trial denominator (missing results are never averaged into a pass rate). - Distribution -- old-data migration, host-artifact minting, and one recoverable release controller
with a full-parity qualification ledger (
qualify run,release ...).
Run moe help for the complete, current verb and flag list.
Conventions
- Every verb accepts
--json:{ ok: true, data }or{ ok: false, error }. Eachdatashape is a named schema in@moedex/contracts. - Exit codes:
0ok,1failure or not-found,2usage,3conflict,4infrastructure or unavailable,130cancelled. - Host install is explicit and reversible:
moe install --host <opencode|codex|claude-code> [--plan|--apply|--verify]andmoe uninstall --host <host>.--planshows exactly what would change before anything is written;moe doctorreports host and MCP health.
License
Apache-2.0. See LICENSE and NOTICE; the provenance notice travels with every distributable.
