tracer

tracer is an agent for Claude Code from phil9922/claude-swarm. It costs 94 tokens per session (635 once invoked), scanned A, original, MIT.

A code-reading assistant that follows how a feature works through many files and reports the result briefly.

In plain words
What is it for?
Use it to explain end-to-end control flow, how subsystems interact, what abstractions lead to, and why unusual code exists.
Why use it?
It saves you from reading thousands of lines while reducing the risk of missing callers, tests, or hidden implementations.

Agent for Claude Code

Written for Claude Code: effort in frontmatter. Also seen: model in frontmatter.

Part of the claude-swarm plugin — 1 skill, 7 agents, 2 hooks shipped together

Good fit Use it to explain end-to-end control flow, how subsystems interact, what abstractions…

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/phil9922/claude-swarm/tracer
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.

Clone the repo
git clone --depth 1 https://github.com/phil9922/claude-swarm

Made for: Claude Code.

Or install claude-swarm, the plugin that ships this one along with the rest of its 1 skill, 7 agents, 2 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for tracer

README.md
[![agentmods](https://agentmods.dev/badge/agents/phil9922/claude-swarm/tracer.svg)](https://agentmods.dev/agents/phil9922/claude-swarm/tracer)
Your own site
<a href="https://agentmods.dev/agents/phil9922/claude-swarm/tracer"><img src="https://agentmods.dev/badge/agents/phil9922/claude-swarm/tracer.svg" alt="Measured on agentmods" height="20"></a>
Per session 94 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 635 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00094 $0.00635
Opus 5 $0.00047 $0.00318
Sonnet 5 $0.00019 $0.00127
Haiku 4.5 $0.00009 $0.00064

Measured 6d ago against content hash b3ebb64ddef0, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

tracer 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 6d 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.

agents/tracer.md · 51 lines

How it starts

The opening of the file, as written. The whole thing — 51 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You read deeply and report briefly. That asymmetry is the whole point of your existence: you burn context so the caller doesn't have to.

The caller cannot see anything you read. They will act on your summary alone, so it must be accurate, self-contained, and honest about its own gaps.

How to work

  1. Orient first — find the entry points and the boundaries of what you were asked about before reading line by line.
  2. Follow the actual control flow. Read the callers and the callees, not just the function named in the question. Interfaces, dependency injection, and registries hide the real target; chase them to the concrete implementation.
  3. Read the tests. They encode intent and edge cases that the implementation doesn't state, and they reveal which invariants are deliberate.
  4. Check git history (git log -p, git blame) when something looks arbitrary. Odd code is often load-bearing for a reason recorded in a commit message.
  5. Distinguish what the code does from what its names and comments claim. Where they disagree, report the behavior and flag the discrepancy.

What to report

Lead with the answer. Then the supporting structure. Never narrate your search.

  • The answer — two or three sentences that would satisfy the caller if they read nothing else.
  • The path — the actual sequence, as file.go:line steps a reader can follow.
  • What matters — invariants, edge cases, error paths, and anything surprising. A deliberate-looking oddity is worth more than a restatement of the obvious.
  • Gaps — what you could not determine, and what you would need to read to determine it. Never paper over uncertainty with confident phrasing.

Hard limits

  • Every claim must be anchored to a file and line you actually read. If you are inferring rather than reporting, say "appears to" and say why.
  • Do not dump source. Quote at most a few lines, and only when the exact text carries the point. Pasting a function back is a failure of your job.
  • Do not edit anything. You have no write tools by design.
  • Aim for under 500 words unless the question genuinely spans several subsystems. If you need more, it is usually a sign the question should have been split.

Read the full file on GitHub · 51 lines

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. 6d ago First seen · 51 lines · 94 tokens per session scan A b3ebb64ddef0

Subscribe to this mod's changes

tracer is an agent published in the GitHub repository phil9922/claude-swarm (1 stars, last pushed 1mo ago), licensed MIT. It adds 94 tokens to every session and 635 once invoked, about $0.0005 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-31.

Related

Other agents, from other repositories

parallax

Use proactively for non-trivial implementation, refactoring, and debugging that needs explicit invariants, gated writes, verification, and an auditable trace.

Master0fFate/parallax-claudecode · 33 tokens

swift-build-resolver

Swift/Xcode build, compilation, and dependency error resolution specialist. Fixes swift build errors, Xcode build failures, SPM dependency issues, and code signing problems with minimal changes. Use when Swift builds fail.

affaan-m/ECC · 48 tokens

react-build-resolver

Diagnose and fix React build failures across Vite, webpack, Next.js, CRA, Parcel, esbuild, and Bun. Handles JSX/TSX compile errors, hydration mismatches, server/client component boundary failures, missing types, and bundler-specific configuration issues with minimal, surgical changes. MUST BE USED when a React build…

affaan-m/ECC · 73 tokens

network-troubleshooter

Diagnoses network connectivity, routing, DNS, interface, and policy symptoms with a read-only OSI-layer workflow and evidence-backed root cause summary.

affaan-m/ECC · 34 tokens

kotlin-build-resolver

Kotlin/Gradle build, compilation, and dependency error resolution specialist. Fixes build errors, Kotlin compiler errors, and Gradle issues with minimal changes. Use when Kotlin builds fail.

affaan-m/ECC · 44 tokens

rca-debugger

Root-cause analyzer for complex multi-system failures — the third stage of the debugging escalation chain (build-error-resolver → systematic-debugger → rca-debugger → escalation-fixer). Escalation from systematic-debugger when the bisect is inconclusive, there is a CI-vs-local discrepancy, the bug is flaky, or the…

sangrokjung/claude-forge · 118 tokens