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

collar dev

Global options apply to every command below; see the command index.

Run project shells, processes, and tasks through devenv

Usage: collar dev <COMMAND>

Commands:
  shell  Enter an interactive project shell
  run    Run a command inside the project shell, preserving literal arguments
  up     Start the project's configured processes
  down   Stop local processes without resolving project ownership or secrets
  task   Run a named devenv task or namespace
  help   Print this message or the help of the given subcommand(s)

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

Examples:
  collar dev shell
  collar dev run -- cargo test
  collar dev up

collar dev shell

Enter an interactive project shell

Usage: collar dev shell [OPTIONS]

Options:
      --profile <PROFILE>
          Secret profile; uses the underlying tool default when omitted

          [env: SECRETSPEC_PROFILE]

      --reason <REASON>
          Audit reason, forwarded unchanged to secretspec and devenv

          [env: SECRETSPEC_REASON]

      --provider <PROVIDER>
          Select a provider alias declared in secretspec.toml

          [env: SECRETSPEC_PROVIDER]

  -h, --help
          Print help

collar dev run

Run a command inside the project shell, preserving literal arguments

Usage: collar dev run [OPTIONS] <COMMAND>...

Arguments:
  <COMMAND>...


Options:
      --profile <PROFILE>
          Secret profile; uses the underlying tool default when omitted

          [env: SECRETSPEC_PROFILE]

      --reason <REASON>
          Audit reason, forwarded unchanged to secretspec and devenv

          [env: SECRETSPEC_REASON]

      --provider <PROVIDER>
          Select a provider alias declared in secretspec.toml

          [env: SECRETSPEC_PROVIDER]

  -h, --help
          Print help

collar dev up

Start the project's configured processes

Usage: collar dev up [OPTIONS]

Options:
  -d, --detach
          Start configured processes in the background

      --profile <PROFILE>
          Secret profile; uses the underlying tool default when omitted

          [env: SECRETSPEC_PROFILE]

      --reason <REASON>
          Audit reason, forwarded unchanged to secretspec and devenv

          [env: SECRETSPEC_REASON]

      --provider <PROVIDER>
          Select a provider alias declared in secretspec.toml

          [env: SECRETSPEC_PROVIDER]

  -h, --help
          Print help

collar dev down

Stop local processes without resolving project ownership or secrets

Usage: collar dev down [OPTIONS]

Options:
      --reason <REASON>
          [env: SECRETSPEC_REASON]

  -h, --help
          Print help

collar dev task

Run a named devenv task or namespace

Usage: collar dev task [OPTIONS] <NAME>

Arguments:
  <NAME>


Options:
      --profile <PROFILE>
          Secret profile; uses the underlying tool default when omitted

          [env: SECRETSPEC_PROFILE]

      --reason <REASON>
          Audit reason, forwarded unchanged to secretspec and devenv

          [env: SECRETSPEC_REASON]

      --provider <PROVIDER>
          Select a provider alias declared in secretspec.toml

          [env: SECRETSPEC_PROVIDER]

  -h, --help
          Print help