Collar

These pages are generated from Collar’s Clap definitions. Use the help shipped with your installed version when it differs from this site. Global options are listed here and apply to every subcommand.

• collar skill
• collar status
• collar docs
• collar completion
• collar issue
• collar label
• collar release
• collar actions
• collar workflow
• collar changelog
• collar secrets
• collar dev
• collar check
• collar rfc
• collar doctor
• collar project
• collar config
• collar auth
• collar repo
• collar pr
• collar api
• collar governance
• collar kennel
• collar infra

Global options

Review Forgejo pull requests, inspect CI and previews, find project documentation, and run local development tools.

Usage: collar [OPTIONS] <COMMAND>

Commands:
  skill       Show or install Collar's bundled agent skill
  status      Show your review requests, authored PRs, and assigned issues across the forge
  docs        Read and search canonical ScottyLabs documentation
  completion  Generate shell completions
  issue       Work with Forgejo issues
  label       Manage repository labels
  release     Inspect and manage repository releases
  actions     Inspect Forgejo Actions runs
  workflow    Inspect or dispatch existing workflows
  changelog   Read ScottyLabs changelogs and tech-lead announcements
  secrets     Check or update project secrets through secretspec
  dev         Run project shells, processes, and tasks through devenv
  check       Run repository hooks inside the project's development shell
  rfc         Search RFCs or create a draft
  doctor      Diagnose local setup and ScottyLabs login readiness
  project     Connect the selected repository to its ScottyLabs project
  config      Manage nonsecret user defaults
  auth        Sign in to Forgejo or OpenBao and check saved credentials
  repo        Clone, inspect, or fork a repository
  pr          Inspect and review pull requests
  api         Send a request to this forge's REST API
  governance  Discover declared ownership and service access without a clone
  kennel      Inspect Kennel deployment reports and retry branch builds
  infra       Inspect canonical infrastructure and build pinned Nix configurations
  help        Print this message or the help of the given subcommand(s)

Options:
      --host <HOST>
          Forge origin; defaults to git.cmu.dev or the Git remote

          [env: COLLAR_HOST]

  -R, --repo <REPO>
          Select REPO, OWNER/REPO, or HOST/OWNER/REPO; default owner: ScottyLabs

      --config <CONFIG>
          Use a specific nonsecret settings file

          [env: COLLAR_CONFIG]

      --cache-dir <CACHE_DIR>
          Override the user cache directory for canonical source snapshots

          [env: COLLAR_CACHE_DIR]

      --no-config
          Ignore saved settings for reproducible automation

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

Examples:
  collar auth login
  collar pr list -R ScottyLabs/collar
  collar pr review 42 --approve
  collar docs search secrets
  collar check --all

Use collar <command> --help for arguments and examples.
Documentation: https://docs.scottylabs.org/collar/