CLI Reference

scut codex config

Codex · config

Install, inspect, and remove Codex hooks.json entries.

scut codex config install
scut codex config install --scope=user
scut codex config status --scope=both --json
scut codex config uninstall

Project scope writes .codex/hooks.json; user scope writes ~/.codex/hooks.json.

Scut writes hooks.json rather than inline TOML hook tables so ownership stays narrow and predictable.

Generated help

Generated from scut codex config --help.

Usage: scut codex config <command> [flags]

Configure Codex hooks.json — install or remove scut hooks.

Commands:
  codex config install      Write/merge scut hook entries into hooks.json.
  codex config uninstall    Remove scut entries from hooks.json.
  codex config status       Show currently-installed scut entries in hooks.json.

Flags:
  -h, --help               Show context-sensitive help.
  -v, --version            Print version and exit.

      --log                Enable logging to ~/.scut/logging/ at info level.
      --log-level=LEVEL    Set log level: debug, info, warn, error (implies
                           --log).

Generated from scut codex config install --help.

Usage: scut codex config install [flags]

Write/merge scut hook entries into hooks.json.

Flags:
  -h, --help                    Show context-sensitive help.
  -v, --version                 Print version and exit.

      --log                     Enable logging to ~/.scut/logging/ at info
                                level.
      --log-level=LEVEL         Set log level: debug, info, warn, error (implies
                                --log).

      --scope="project"         Hooks scope: project or user.
      --only=ONLY,...           Comma-separated list of hook event slugs to
                                install. Defaults to post-tool-use.
      --bake-log                Bake --log into generated command strings.
      --bake-log-level=LEVEL    Bake --log-level=LEVEL into generated command
                                strings (implies --bake-log). One of: debug,
                                info, warn, error.
      --dry-run                 Print resulting hooks.json to stdout instead of
                                writing.

Generated from scut codex config status --help.

Usage: scut codex config status [flags]

Show currently-installed scut entries in hooks.json.

Flags:
  -h, --help               Show context-sensitive help.
  -v, --version            Print version and exit.

      --log                Enable logging to ~/.scut/logging/ at info level.
      --log-level=LEVEL    Set log level: debug, info, warn, error (implies
                           --log).

      --scope="both"       Which scope(s) to inspect.
      --json               Emit a structured JSON object instead of the
                           human-readable table.

Generated from scut codex config uninstall --help.

Usage: scut codex config uninstall [flags]

Remove scut entries from hooks.json.

Flags:
  -h, --help               Show context-sensitive help.
  -v, --version            Print version and exit.

      --log                Enable logging to ~/.scut/logging/ at info level.
      --log-level=LEVEL    Set log level: debug, info, warn, error (implies
                           --log).

      --scope="project"    Hooks scope: project or user.
      --only=ONLY,...      Comma-separated list of hook event slugs to remove.
                           Defaults to all scut-owned hook events.
      --dry-run            Print resulting hooks.json to stdout instead of
                           writing.