CLI reference

The dna binary is a thin wrapper over the DNA kernel — every command boots a local kernel against DNA_SOURCE_URL / DNA_BASE_DIR, runs one command, and exits. No service is required.

These pages are generated from the Click command definitions by scripts/gen_cli_docs.py, so --help and the docs can never drift.

Group	What it does
dna sdlc	Declarative lifecycle tracking (Roadmap/Epic/Feature/Story/Issue).
dna research	Manage Research synthesis instances (curated syntheses of References).
dna docs	Browse the in-product Doc corpus.
dna scope	List + inspect scopes (manifest modules).
dna kind	List + inspect registered Kinds.
dna source	Source-level operations: declarative replicas, introspection.
dna api	Expose the live DNA (definitions + memory) over a REST read-API.
dna copilot	Copilot kits — fluxos completos instaláveis como instâncias.
dna definition	Read and customize a tenant's definition overrides (the Strain).
dna emit	Emit a DNA agent as a target runtime's native artifact (the de-para).
dna eval	Run EvalSuites locally (offline, deterministic) and compare runs against a pinned EvalBaseline.
dna explain	Show per-section provenance for a composed agent prompt.
dna genome	The Genome view — a module's identity, contents (ships), and Strain policy.
dna graph	The derived reference graph (declared relations).
dna init	Make a project agent-ready: board + skill + AGENTS.md + git hooks.
dna install	Install bundles/Kinds from a repository into the local source.
dna instance	List, show, create, edit, delete instances.
dna intel	Portfolio intelligence — run passes, inspect sources + insights.
dna invalidation	O custo da invalidação de cache (i-123), lido do log.
dna mcp	Expose the live DNA (definitions + SDLC + memory) over MCP.
dna memory	Declarative memory over existing Kinds (remember/recall/forget/consolidate).
dna new	Scaffold a valid skeleton into a scope — an INSTANCE (agent | soul | guardrail | tool), or a KIND of your own (kind).
dna recall	Hybrid semantic search (dense + lexical + RRF) over the scope's records.
dna rename	Rename an instance and repoint the AUTHORED references to it.
dna run	Run AGENT_NAME or a RuntimeBinding through a consumer harness.
dna search	Alias of dna recall (neutral naming).
dna solution	Scaffold and update a repo from Copier templates.
dna specify	Bidirectional GitHub Spec Kit ↔ DNA bridge (import / export).