Transcript Lake

Documentation / CLI

transcript-lake hooks

Inspect canonical adaptive-hook decision events.

Invocation#

sh
transcript-lake [--data-dir <path>] hooks [--decision <value>] [--tool <name>] [--limit <n>] [--json]

Purpose#

Inspect canonical adaptive-hook decision events.

Inputs and options#

  • --decision <value> filters the decision exactly.
  • --tool <name> filters the deciding hook ID exactly.
  • --limit <n> keeps the newest n; without it every decision is listed. --json selects JSON output.

Output and state effect#

Read-only. Lists timestamp, session, project, hook ID, decision, hook event, infrastructure, and reason from hook_decisions, newest first.

Exact refusals#

  • --limit must be a whole number of at least one; omit it to list every hook decision.
  • Any positional argument is refused as hooks accepts flags only.
  • An unrecognized --wat is refused as unknown hooks flag: --wat.
  • Repeating --json is refused as hooks received duplicate --json.

All long flags are exact and single-use. A value flag never consumes another --flag. Global --data-dir may appear anywhere in the invocation, must appear once, and selects an absolute root.

Back to the complete CLI command tree.