black-box
by lilyjazz
Shopping & E-commerceBrief
Indestructible audit logs for agent actions, stored in TiDB Zero.
Description
What This Skill Does
Streams agent actions, errors, and reasoning chains to a TiDB Zero cloud database in real-time as persistent audit logs. Survives container crashes and environment resets. Supports both user-supplied credentials and auto-provisioned temporary databases.
Unlike local log files, cloud-persisted logs survive container crashes and remain queryable after the agent environment is gone.
When to Use It
- Retrieving the last 100 actions before a production agent crash
- Proving agent behavior for compliance audits
- Debugging a multi-step agent run that failed mid-execution
- Persisting logs across ephemeral CI/CD containers
- Tracking error patterns across repeated agent runs
Example Workflow
User asks: What did the agent do before it crashed?
- 1
Connect to TiDB Zero using TIDB_* credentials or auto-provisioned DSN
- 2
Query the agent_logs table for the most recent entries
- 3
Filter by ERROR level and sort by timestamp descending
- 4
Return the last 20 log entries with message and metadata fields
A list of 20 timestamped log entries showing the agent's actions and errors leading up to the failure
Requirements
- TIDB_HOST environment variable
- TIDB_PORT environment variable
- TIDB_USER environment variable
- TIDB_PASSWORD environment variable
- TiDB Zero account (if using auto-provisioning fallback)
Installation
clawhub install lilyjazz/black-boxRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.