Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Commands

adrs provides commands for managing Architecture Decision Records.

Overview

CommandDescription
initInitialize a new ADR repository
newCreate a new ADR
editEdit an existing ADR
listList all ADRs
searchSearch ADRs for matching content
statusChange an ADR's status
linkLink two ADRs together
exportExport ADRs to different formats
importImport ADRs from different formats
generateGenerate documentation
templateManage ADR templates
configShow configuration
doctorCheck repository health
completionsGenerate shell completions
cheatsheetShow quick reference

Global Options

These options are available for all commands:

OptionDescription
--ngUse NextGen mode (YAML frontmatter)
-C, --cwd <DIR>Run as if started in <DIR>
-h, --helpPrint help information
-V, --versionPrint version information

Usage

adrs [OPTIONS] <COMMAND>

Commands:
  init         Initialize a new ADR repository
  new          Create a new ADR
  edit         Edit an existing ADR
  list         List all ADRs
  search       Search ADRs for matching content
  link         Link two ADRs together
  status       Change an ADR's status
  config       Show configuration
  doctor       Check repository health
  generate     Generate documentation
  export       Export ADRs to different formats
  import       Import ADRs from different formats
  template     Manage ADR templates
  completions  Generate shell completions
  cheatsheet   Show quick reference for common workflows
  help         Print this message or the help of the given subcommand(s)

Options:
      --ng                 Use next-gen mode (YAML frontmatter, enhanced features)
  -C, --cwd <WORKING_DIR>  Working directory (defaults to current directory)
  -h, --help               Print help
  -V, --version            Print version