Command-Line Help for dadrock¶

This document contains the help content for the dadrock command-line program.

Command Overview:

• dadrock↴
• dadrock help↴
• dadrock commands↴
• dadrock completions↴
• dadrock dir↴
• dadrock config↴
• dadrock init↴
• dadrock demo↴
• dadrock new↴
• dadrock list↴
• dadrock status↴
• dadrock status accept↴
• dadrock status reject↴
• dadrock status supersede↴
• dadrock validate↴
• dadrock validate records↴
• dadrock validate links↴
• dadrock validate tags↴
• dadrock tags↴
• dadrock tags list↴
• dadrock mcp↴
• dadrock mcp serve↴
• dadrock agent↴
• dadrock agent check↴
• dadrock agent draft↴
• dadrock agent skills↴
• dadrock task↴
• dadrock task list↴
• dadrock task show↴
• dadrock task run↴
• dadrock task runs↴
• dadrock task result↴
• dadrock preview↴

dadrock¶

DADR decision records and web review UI.

With no command, prints this help menu.

Usage: dadrock [COMMAND]

Subcommands:¶

• help — Show top-level help or detailed metadata for one command.
• commands — List command metadata for automation and command discovery.
• completions — Generate a shell completion script.
• dir — Print the discovered accepted records directory.
• config — Print the resolved project layout.
• init — Create a Dadrock dadr/ directory.
• demo — Seed a new project with a named DADR example.
• new — Create a candidate decision record from the active candidate template.
• list — List records, optionally filtered by lifecycle status, tag, or query.
• status — Inspect one record's lifecycle status or run lifecycle transitions.
• validate — Run project validation, or target records, links, or tags.
• tags — Inspect DADR tag usage.
• mcp — Serve Dadrock MCP tools over stdio.
• agent — Call a configured local ACP agent for candidate drafting.
• task — Discover, inspect, and run Dadrock task packages.
• preview — Serve the local web review UI.

dadrock help¶

Show top-level help or detailed metadata for one command.

Usage: dadrock help [TOPIC]...

Arguments:¶

• <TOPIC>

dadrock commands¶

List command metadata for automation and command discovery.

Usage: dadrock commands [OPTIONS]

Options:¶

• --json

dadrock completions¶

Generate a shell completion script.

Usage: dadrock completions <SHELL>

Arguments:¶

• <SHELL>

Possible values: bash, zsh, fish

dadrock dir¶

Print the discovered accepted records directory.

Usage: dadrock dir

dadrock config¶

Print the resolved project layout.

Usage: dadrock config [OPTIONS]

Options:¶

• --json

dadrock init¶

Create a Dadrock dadr/ directory.

Usage: dadrock init [DIRECTORY]

Arguments:¶

• <DIRECTORY>

dadrock demo¶

Seed a new project with a named DADR example.

Usage: dadrock demo [OPTIONS] [DIRECTORY]

Arguments:¶

• <DIRECTORY>

Options:¶

• --json
• --example <EXAMPLE>

Default value: lifecycle

Possible values: lifecycle, candidate-review, penguins, broken, conflicts, task-history

dadrock new¶

Create a candidate decision record from the active candidate template.

Usage: dadrock new [OPTIONS] <TITLE>...

Arguments:¶

• <TITLE>

Options:¶

• --tag <TAGS>
• --quiet

dadrock list¶

List records, optionally filtered by lifecycle status, tag, or query.

Usage: dadrock list [OPTIONS]

Options:¶

• --status <STATUS>

Possible values: candidate, accepted, rejected, superseded

• --tag <TAG>
• --query <QUERY>
• --unique

dadrock status¶

Inspect one record's lifecycle status or run lifecycle transitions.

Usage: dadrock status [QUERY]... [COMMAND]

Subcommands:¶

• accept — Accept a candidate by converting it into an accepted decision.
• reject — Reject a candidate and move it into the rejected records directory.
• supersede — Link accepted successors to the records they supersede.

Arguments:¶

• <QUERY>

dadrock status accept¶

Accept a candidate by converting it into an accepted decision.

Usage: dadrock status accept <QUERY>...

Arguments:¶

• <QUERY>

dadrock status reject¶

Reject a candidate and move it into the rejected records directory.

Usage: dadrock status reject <QUERY>...

Arguments:¶

• <QUERY>

dadrock status supersede¶

Link accepted successors to the records they supersede.

Usage: dadrock status supersede [OPTIONS]

Options:¶

• --from <FROM>
• --to <TO>

dadrock validate¶

Run project validation, or target records, links, or tags.

Usage: dadrock validate [OPTIONS] [COMMAND]

Subcommands:¶

• records — Validate record front matter and structure.
• links — Report broken or ambiguous wikilinks and local Markdown links.
• tags — Report malformed YAML and inline tags.

Options:¶

• --json

dadrock validate records¶

Validate record front matter and structure.

Usage: dadrock validate records [OPTIONS] [PATHS]...

Arguments:¶

• <PATHS>

Options:¶

• --json

dadrock validate links¶

Report broken or ambiguous wikilinks and local Markdown links.

Usage: dadrock validate links [OPTIONS]

Options:¶

• --json

dadrock validate tags¶

Report malformed YAML and inline tags.

Usage: dadrock validate tags [OPTIONS]

Options:¶

• --json

dadrock tags¶

Inspect DADR tag usage.

Usage: dadrock tags <COMMAND>

Subcommands:¶

• list — List normalized YAML and inline tags.

dadrock tags list¶

List normalized YAML and inline tags.

Usage: dadrock tags list [OPTIONS]

Options:¶

• --json

dadrock mcp¶

Serve Dadrock MCP tools over stdio.

Usage: dadrock mcp <COMMAND>

Subcommands:¶

• serve — Serve Dadrock MCP tools over stdio.

dadrock mcp serve¶

Serve Dadrock MCP tools over stdio.

Usage: dadrock mcp serve [OPTIONS] [DIRECTORY]

Arguments:¶

• <DIRECTORY>

Options:¶

• --read-only

dadrock agent¶

Call a configured local ACP agent for candidate drafting.

Usage: dadrock agent <COMMAND>

Subcommands:¶

• check — Check that a local ACP agent can start a Dadrock session.
• draft — Ask a local ACP agent to draft a candidate decision.
• skills — List available Dadrock agent skills and prompt packs.

dadrock agent check¶

Check that a local ACP agent can start a Dadrock session.

Usage: dadrock agent check [OPTIONS]

Options:¶

• --agent <AGENT>
• --agent-arg <AGENT_ARGS>
• --no-mcp

dadrock agent draft¶

Ask a local ACP agent to draft a candidate decision.

Usage: dadrock agent draft [OPTIONS] <PROMPT>...

Arguments:¶

• <PROMPT>

Options:¶

• --write
• --json
• --permission <PERMISSION>

Default value: deny

Possible values: deny, allow-once, allow-always

• --agent <AGENT>
• --agent-arg <AGENT_ARGS>
• --skill <SKILLS> [alias: prompt-pack]
• --no-mcp

dadrock agent skills¶

List available Dadrock agent skills and prompt packs.

Usage: dadrock agent skills [OPTIONS]

Options:¶

• --json

dadrock task¶

Discover, inspect, and run Dadrock task packages.

Usage: dadrock task <COMMAND>

Subcommands:¶

• list — List built-in, user, and project task packages.
• show — Show one resolved task package.
• run — Run one resolved task package with a local ACP agent.
• runs — List persisted local task runs.
• result — Read a persisted task run result.

dadrock task list¶

List built-in, user, and project task packages.

Usage: dadrock task list [OPTIONS]

Options:¶

• --json

dadrock task show¶

Show one resolved task package.

Usage: dadrock task show [OPTIONS] <TASK_ID>

Arguments:¶

• <TASK_ID>

Options:¶

• --json

dadrock task run¶

Run one resolved task package with a local ACP agent.

Usage: dadrock task run [OPTIONS] --input-json <INPUT_JSON> <TASK_ID>

Arguments:¶

• <TASK_ID>

Options:¶

• --input-json <INPUT_JSON>
• --json
• --permission <PERMISSION>

Default value: deny

Possible values: deny, allow-once, allow-always

• --agent <AGENT>
• --agent-arg <AGENT_ARGS>
• --no-mcp

dadrock task runs¶

List persisted local task runs.

Usage: dadrock task runs [OPTIONS]

Options:¶

• --json

dadrock task result¶

Read a persisted task run result.

Usage: dadrock task result [OPTIONS] <RUN_ID>

Arguments:¶

• <RUN_ID>

Options:¶

• --json

dadrock preview¶

Serve the local web review UI.

Usage: dadrock preview [OPTIONS] [DIRECTORY]

Arguments:¶

• <DIRECTORY>

Options:¶

• --port <PORT>

Default value: 4004 * --host <HOST>

Default value: 127.0.0.1

This document was generated automatically by clap-markdown.