rrt CLI

Usage:  rrt [OPTIONS] <command>

repo-release-tools: branch, commit, and version helpers for Git repositories.

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Arguments
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Options
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  -h, --help                   Show this message and exit.
  --version                    Show version and exit.
  --format FORMAT              Output format. Defaults to text.
  --no-color                   Disable all ANSI color output.
  -v, --verbose                Increase output verbosity (-v summary, -vv details, -vvv debug).
  --generate-completion SHELL  Print shell completion script for SHELL and exit.

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Version & Release
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  bump        Bump project version using [tool.rrt] config.
  changelog   Commands for working with the project changelog.
  ci-version  Compute and apply CI pre-release versions (PEP 440 / SemVer).
  release     Release-specific workflows and checks.
  workspace   Apply a unified version bump to every listed package.
  tag         Create annotated git tags from the current configured version, or check that existing tags follow the naming convention.

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Repository Health
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  doctor     Validate the core automation wiring for the current repository.
  artifacts  Hash and verify generated files against a committed fingerprint lock.
  config     Inspect the resolved rrt configuration after discovery and auto-detection.
  env        Show environment variables and interpreter details that affect rrt behavior.
  eol        Check detected host runtimes and project minimum versions against end-of-life dates.
  toc        Read a Markdown file and print a nested bullet-list TOC to stdout.
  tree       Render a directory tree from the selected root while respecting gitignore rules.
  docs       Scan source files and extract inline documentation blocks
  drift      Lock and check the repo's agent-facing surfaces, such as Claude hooks, agent prompts, and shared skill docs.
  folder     Supervise folder structures against config-defined rules or built-in templates, scaffold missing structure, and infer new templates from existing trees.

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
CI & Automation
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  action  Scaffold a starter GitHub Actions workflow that runs repo-release-tools checks.

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Git Workflow
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  branch  Branch management helpers for conventional branch naming.
  git     Git workflow helpers for repository status, commit, sync, and history operations.

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Setup & Tooling
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  install  Install one or more bundled rrt agent surfaces (skill, agents, hooks) into one or more local/global targets.
  init     Generate a starter rrt configuration for the current repository or manifest.
  skill    Install the bundled rrt user workflow skills.
  agents   Install bundled rrt user agents into one or more local or global agent directories.
  hooks    Install bundled rrt user workflow hook scripts into one or more local hook directories and update the surface's hook registration JSON.

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Examples
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  $ rrt branch new feat "add parser"
  $ rrt branch rename --type fix --scope api "repair config loader"
  $ rrt bump patch --dry-run
  $ rrt release check
  $ rrt action init
  $ rrt drift check
  $ rrt git status
  $ rrt doctor
  $ rrt install --target claude-local
  $ rrt skill install --target copilot-local
  $ rrt @args.txt