Coding Trace Collect

What it does

When your agent uses it

• Running collectllmtraces.py
• Extractclauderounds.py
• Extractcodexrounds.py
• Collectalluserssudo.sh

Example prompts

• “/coding-trace-collect”

Requirements

• Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Work from the coding-trace repo root, identified by pyproject.toml, README.md, and scripts/collect_llm_traces.py.
2. 2Run every Python entry point through uv run python ....
3. 3Decide scan scope before running commands
4. 4Decide write behavior
5. 5Do not publish private outputs until $coding-trace-sanitize has been applied.
6. 6After sanitization, use $coding-trace-analyze for artifact and validator dispatchers. Collection should not own plotting outputs or…

What it can do on your machine

Read from SKILL.md and the folder at commit 11b8b14. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • uv

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Coding Trace Collect loads about 1.9k tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 627 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~98

When it runs · the whole SKILL.md, loaded when a task matches

~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteRuns commands with sudoSKILL.md:18

  under `/home`: use `--all-user`, or the sudo wrapper when unreadable homes are expected. Use `--home-root PATH` for non

• NoteRuns commands with sudoSKILL.md:21

  - The sudo wrapper's default dated output is a fresh snapshot of currently readable sessions.

• NoteRuns commands with sudoSKILL.md:57

  Use the sudo wrapper for a fresh, named all-user snapshot while preserving final file

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from uw-syfi/TraceLab at commit 11b8b14, republished under its Apache-2.0 licence (© uw-syfi). 627 words, ~1,911 tokens.

name

coding-trace-collect

description

Collect, count, and extract Claude Code and Codex CLI local histories into normalized coding-trace JSONL files. Use when running collect_llm_traces.py, extract_claude_rounds.py, extract_codex_rounds.py, collect_all_users_sudo.sh, scanning current-user or all-user homes, choosing output paths, using --fresh-extract or --append-dedup, or troubleshooting extraction counts.

uv run python scripts/collect_llm_traces.py

uv run python scripts/collect_llm_traces.py --extract-rounds

uv run python scripts/collect_llm_traces.py --extract-rounds trace/llm_round_trace.jsonl --fresh-extract

uv run python scripts/collect_llm_traces.py --all-user --extract-rounds

collection_id="20260724-100b"
scripts/collect_all_users_sudo.sh \
  --collection-id "$collection_id" \
  --fresh-extract

uv run python scripts/merge_round_traces.py \
  trace/collections/current/merged.private.jsonl \
  "trace/collections/${collection_id}/hosts/"*.all_users.jsonl \
  -o "trace/collections/${collection_id}/merged.private.jsonl"

collection_id="20260724-100b"

uv run python scripts/collect_llm_traces.py \
  --extract-rounds "trace/collections/${collection_id}/merged.private.jsonl" \
  --fresh-extract

uv run python scripts/sanitize_round_trace.py \
  "trace/collections/${collection_id}/merged.private.jsonl" \
  -o "trace/collections/${collection_id}/merged.public.jsonl"

uv run python artifacts/llm_generation/timing_fit/collect_timing_fit_trace.py \
  --db trace/collections/current/merged.public.duckdb \
  -o artifacts/llm_generation/timing_fit/timing_fit_trace.csv

uv run python scripts/extract_claude_rounds.py ~/.claude/projects/PROJECT_DIR -o trace/claude_round_trace.jsonl --append-dedup

uv run python scripts/extract_codex_rounds.py ~/.codex/sessions -o trace/codex_round_trace.jsonl --append-dedup

uv run python artifacts/trace_facts/overview_summary/analyze.py -i trace/collections/current/merged.private.jsonl

uv run python artifacts/trace_facts/overview_summary/analyze.py -i trace/collections/current/merged.private.jsonl --json

© uw-syfi, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/coding-trace-collect of uw-syfi/TraceLab.

• SKILL.md
• agents/openai.yaml

Open the folder on GitHubat commit 11b8b14