hades-export-traces

Instructions for exporting Hades trace data from its SQLite database. SQLite is a file-based database that can be opened with tools such as DB Browser for SQLite, DBeaver, or the sqlite3 command line.

In plain words
What is it for?
Use it to copy trace data, inspect traces and nested spans, or share activity records for analysis. Review the database for private project details before sending it elsewhere.
Why use it?
It explains where trace files are stored in current and older installations and how to share them for analysis. It also warns that traces may contain project paths and query parameters.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/thearcforge/hades/export-traces
Clone the repo
git clone --depth 1 https://github.com/TheArcForge/Hades
Per session 15 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 251 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00015 $0.00251
Opus 5 $0.00008 $0.00125
Sonnet 5 $0.00003 $0.00050
Haiku 4.5 $0.00002 $0.00025

Measured 2d ago against content hash d661cd6d6019, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

hades-export-traces scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

ClaudeCodePlugin/commands/export-traces.md · 20 lines

What it actually says

Help the user export trace data. The database location depends on what they have installed for this project:

  1. Standalone app (v2, the default today): the SQLite file is in Hades' app storage, not the project folder: ~/Library/Application Support/Hades/projects/<productGUID>/traces.db. The project handle hades_status returns for this project is that productGUID.
  2. Legacy Unity package (v1.2), if still installed in this project: the SQLite file is at <project>/.arcforge/traces.db, inside the project itself.

Either way:

  • The database file can be opened with any SQLite client (DB Browser for SQLite, DBeaver, sqlite3 CLI).
  • For sharing: the user can copy the trace database file. It contains all trace and span data.

Tables of interest:

  • traces — top-level trace records (one per MCP tool call)
  • spans — individual spans within traces (nested operations)

Privacy note: traces may contain file paths and query parameters from the project. Review before sharing externally.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 20 lines · 15 tokens per session scan A d661cd6d6019

Subscribe to this mod's changes

hades-export-traces is a command published in the GitHub repository TheArcForge/Hades (27 stars, last pushed 6d ago), licensed MIT. It adds 15 tokens to every session and 251 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.