persona-inspect

Debug incorrect persona behavior by inspecting aggregated SQLite persona data and LLM trace records using a single CLI command. The tool performs read-only diagnostics across multiple persona_ tables to pinpoint cross-table aggregation issues and relationship signals.

Inspect LLM latency metrics and error distributions by running the trace subcommand on the target SQLite database. It formats round-level think, tool_call, and tool_result details while displaying max_rounds, daily usage, and latency percentiles for the specified bot.

Yes, you can list DDL schemas for all persona_ prefixed tables without modifying the database. The tool requires only read-only access via the --db and --bot-id parameters, ensuring safe schema discovery and targeted diagnosis during troubleshooting.

Persona score changes can be diagnosed by inspecting cross-table persona aggregations, recent message history, and relationship signals. The tool aggregates user persona state from the SQLite database to reveal score modifications and today's usage patterns for the target bot.

The best way to trace LLM call chains is using the dedicated trace inspection subcommand on the SQLite database. It formats the round-level trace pipeline details, exposing LLM health metrics and tool call sequences to isolate failures within a specific bot's execution flow.