
blackbox
Zero-dependency telemetry plugin for Claude Code - captures file modifications for dataset generation and disaster recovery
- version
- 1.0.0
Install
/plugin install blackbox@dot-claudeRun it inside Claude Code after adding the marketplace with /plugin marketplace add pproenca/dot-claude-old.
Contents
Discovered from sourceSkills 1
Blackbox Flight Recorder
Zero-dependency telemetry plugin that captures file snapshots before modifications.
What It Captures
- PreToolUse (Write/Edit/MultiEdit) - Snapshots file before modification
- UserPromptSubmit - Logs user prompts
- SessionStart - Logs session boundaries
Scripts
Query Events
python3 scripts/query.py --last 10 # Last 10 events
python3 scripts/query.py --event-type PreToolUse # Filter by type
python3 scripts/query.py --file myfile.py # Filter by file
python3 scripts/query.py --stats # Storage statistics
Restore Files
python3 scripts/restore.py --list # List recent snapshots
python3 scripts/restore.py --search myfile # Find snapshots by pattern
python3 scripts/restore.py --hash <sha1> > restored.py # Restore by hash
Scripts location: skills/blackbox/scripts/
Limitations
- Files >2MB skipped
- Binary files skipped
- No automatic rotation
References
- Data format: See references/schema.md
- Status command: Run
/blackbox:status
Commands 1
Show blackbox flight recorder status including storage usage and recent events.
Instructions:
-
Run the query script with --stats:
python3 "$CLAUDE_PLUGIN_ROOT/skills/blackbox/scripts/query.py" --stats -
Show last 5 events:
python3 "$CLAUDE_PLUGIN_ROOT/skills/blackbox/scripts/query.py" --last 5 -
Present findings in a concise summary format.
Sponsors
Details
- Marketplace
- pproenca/dot-claude-old
- Source
- plugins/specialized/blackbox
- Category
- Community
- License
- MIT
- Keywords
- telemetry, file-tracking, dataset-generation, disaster-recovery