CLI Reference

This page is the readable entrypoint for the commands most users should learn first. For complete live behavior, run mdkg --help and command-specific help in your installed version.

Core commands

• mdkg init --agent initializes repo-local project memory for human and agent workflows.
• mdkg index rebuilds local search and capability caches.
• mdkg status inspects repo, package, graph, selected-goal, cache, and project DB health.
• mdkg new creates graph nodes and workflow files.
• mdkg show inspects a node.
• mdkg search finds graph nodes.
• mdkg goal manages long-running objectives and active work routing.
• mdkg task starts, updates, and completes task-like work nodes.
• mdkg pack builds deterministic context for a work node.
• mdkg handoff create creates copy-ready agent handoffs.
• mdkg validate validates graph integrity and warning categories.
• mdkg skill manages repo-local agent skills and mirrors.
• mdkg fix plans and applies selected repairs, including ID repair.

Advanced alpha commands

The CLI also includes advanced graph, archive, bundle, subgraph, project DB queue, MCP, workflow mirror, and graph movement commands. Treat those surfaces as public alpha and validate them in your repo before depending on them.

Use these docs next:

• Read-only MCP
• Subgraphs and bundles
• Graph movement
• Demo graphs
• Project DB and queues

Maintainers can refresh this reference from the command contract with:

npm run docs:generate
npm run docs:check

For integration metadata, see dist/command-contract.json in the mdkg repository.