Local-first CLI for planning, documentation, and execution workflows with agent assistance.
npm install mcodamcoda is a local-first CLI for planning, documentation, and execution workflows with agent assistance.
npm i -g mcodamcoda --versionsh
mcoda set-workspace --workspace-root .
mcoda docs pdr generate --workspace-root . --project WEB --rfp-path docs/rfp/web.md --agent codex
`Docdex & QA
- mcoda depends on the docdex CLI for doc search and context stitching.
- Run docdex setup to install Playwright and at least one browser for qa-tasks.
- Docdex stores state under ~/.docdex; mcoda does not create repo-local .docdex folders.
- If ~/.docdex/agents.md exists, it is prepended to every agent run.Workspace layout
- .mcoda/config.json for defaults (docdex URL, branch metadata, telemetry preferences).
- .mcoda/mcoda.db for backlog, jobs, and telemetry.
- .mcoda/docs/ for generated artifacts.Common commands
- Docs: mcoda docs pdr generate, mcoda docs sds generate
- Specs: mcoda openapi-from-docs
- Planning: mcoda create-tasks, mcoda refine-tasks, mcoda order-tasks
- Execution: mcoda work-on-tasks, mcoda code-review, mcoda qa-tasks
- Backlog: mcoda backlog, mcoda task
- Jobs/telemetry: mcoda jobs, mcoda tokens, mcoda telemetry
- Agents: mcoda test-agent, mcoda agent-run
- Updates: mcoda update --checkConfiguration
Environment variables are optional overrides for workspace settings:
- MCODA_DOCDEX_URL to point at a docdex server.
- MCODA_API_BASE_URL or MCODA_JOBS_API_URL for job APIs.
- MCODA_TELEMETRY set to off to disable telemetry.
- MCODA_STREAM_IO=1 to emit agent I/O lines to stderr.Programmatic usage
`ts
import { McodaEntrypoint } from "mcoda";await McodaEntrypoint.run(["--version"]);
`Documentation
Full docs live in the repository:
- README: https://github.com/bekirdag/mcoda
- Usage guide: https://github.com/bekirdag/mcoda/blob/main/docs/usage.md
- Quality gates: https://github.com/bekirdag/mcoda/blob/main/docs/quality_gates.mdLicense
MIT - see LICENSE`.