Skip to content
Documentation
Plugins
cmd

cmd

Every Bash output archived raw, filtered for the model, measured.

SurfacesPreToolUse(Bash) hook → rtok run -- <cmd>; rtok expand <id>
Specthe spec (replaces) column of the catalogue in plan.md §1
Defaulton

How it works

  1. The PreToolUse hook rewrites command to rtok run -- <command> unless the command first word is in never_wrap (default rtok, sudo), or it contains a heredoc, & background, or -i/--interactive.
  2. rtok run executes via $SHELL -lc, keeps the exit code, writes the raw output to ~/.rtok/archive/<id> and an archive row.
  3. A per-family formatter (cargo, git, test runners, ls/find; measurement kind formatter) summarises the output. Other families go through the TOML rules in rules/default.toml (kind rule): head/tail/dedupe/drop, always keeping error|warning|panic|FAIL|Traceback.
  4. Output over 40 lines gets a trailer: [rtok <id> · N lines · expand: rtok expand <id>].
  5. Non-zero exit → last 80 lines verbatim. Nothing is redacted.

Config 

[plugins.cmd]
enabled = true
rewrite = true                   # false: never rewrite Bash commands
never_wrap = ["rtok", "sudo"]    # first-word deny list for the rewrite

Tasks

See roadmap.md § cmd. Checks in plan.md.

T3.1 rtok run · T3.2 rule engine · T3.3 formatters + default rules · T3.4 PreToolUse rewrite · T3.1–T3.6 done 2026-09-02 · T10.2 rtok filter --stdin (OpenCode).

Status

T3.1–T3.6 T10.2 done 2026-09-02.

archivegraph