blackbox

Reviewed at commit dbd2f30

Caution: Saves every prompt, tool call with arguments and tool output, which can include secrets, to a JSONL file in a fixed folder outside your project that persists after the session.

BLACK BOX RECORDER: structured per-session timeline of prompts, model steps, tool calls, subagents and denials; /blackbox prints it

Made by
ucsandman
What we checked

Records a timeline of each session (prompts, model steps with token counts, tool calls with arguments and results, subagent starts and denials) and prints it with /blackbox. The recording is written continuously to a file on disk and kept after the session. It makes no network calls.

Review details

Static review of the source at the pinned commit; not run. Registers session.start (reads the session id, registers the /blackbox command, starts a 2-second timer that flushes), prompt.submit (records the prompt text), turn.step, tool.call (records the full tool arguments, result text, error or denial, and duration), agent.spawn, turn.complete and command.run for /blackbox. Each flush rewrites the whole <sessionId>.jsonl with $.fs.write into the hard-coded folder C:/Projects/claude-mods-rnd/lab/demos/blackbox/recordings/, which is the author's own Windows path and is not under the project; write errors are silently ignored. Prompt and tool output text is stored in full, unredacted in the file, though /blackbox prints only shortened lines. Nothing is sent over the network and tool calls are passed through unchanged.

What it uses
  • Reads your prompts: yes
  • Sees tool calls: yes
  • Blocks or changes tool calls: no
  • Reads or writes files: yes
  • Runs programs on your machine: no
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes
Hooked events
Made this mod? Add a badge to your README

modsforClaude badge for blackbox

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/blackbox.svg)](https://modsforclaude.com/mods/blackbox/)

← All mods