CLI Reference

Root command, command groups, configuration commands, hook entry points, and diagnostics.

scut is the root command for the CLI. Use it directly for top-level actions such as setup, diagnostics, updates, and version output. Use command groups when you need a family of related subcommands, such as agent hooks, config installers, formatters, Go documentation lookup, logging maintenance, or MCP utilities.

Each reference page covers one command or command group. The generated help blocks are snapshots from the current scut binary and remain the authoritative flag listing for the documented command.

Top-level commands

Command	Purpose
`scut version`	Print the installed scut version.
`scut init`	Install scut hook configuration for supported agents.
`scut doctor`	Diagnose installed hook configuration.
`scut update`	Update scut when the install method supports automatic updates.

Command groups

Command groups contain subcommands. Run scut <group> --help to list the commands in a group, then use the linked reference page for details.

Group	Purpose
`scut claude`	Claude Code hooks, status line, and configuration commands.
`scut codex`	Codex hooks and lifecycle integration commands.
`scut format`	Source formatting commands.
`scut gotools`	Go tool-inspired commands for agents.
`scut logging`	scut log maintenance commands.
`scut mcp`	MCP utilities, including the AWS MCP proxy.

Generated help

Generated from scut --help.

Usage: scut <command-or-group> [flags]

CLI tool for managing AI coding agents, hooks, MCP utilities, and developer
helper commands.

Commands:
  version    Print version and exit.
  init       Set up scut hooks for detected or selected coding agents.
  doctor     Diagnose scut hook setup for supported coding agents.
  update     Update scut when the install method supports automatic updates.

Command groups:
  Command groups contain related subcommands. Run "scut <group> --help" to list
  the commands inside a group.

  claude     Claude Code agent commands — hooks, status line, and configuration.
  codex      Codex agent commands — hooks and lifecycle integrations.
  format     Format source code files.
  gotools    Go tool-inspired commands for agents.
  logging    Manage scut log files.
  mcp        MCP utility commands for agents.

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

Run "scut <command-or-group> --help" for more information.

scut init Unified setup for supported agent integrations. scut doctor Read-only setup diagnostics. scut update Update release-installed scut binaries or print package-manager guidance. scut claude config Install, inspect, and remove Claude Code settings entries. scut codex Codex hook and configuration commands. scut codex config Install, inspect, and remove Codex hooks.json entries. scut claude hook Claude Code hook subprocess commands. scut claude status-line Render the Claude Code status bar from session JSON. scut codex hook Codex command-hook subprocess commands. scut logging Clean and inspect scut JSONL logs. scut format Format source files through scut's formatter integrations. scut gotools Go documentation lookup commands for agents. scut mcp MCP utility commands for agents. scut version Print the installed scut version.