loom-advisor

loom-advisor is an agent for Claude Code from cosmix/loom. It costs 53 tokens per session (689 once invoked), scanned A, original, MIT.

A read-only helper for finding the cause of difficult bugs and repeated failures. It investigates source code, tests, configuration, and logs, then gives a diagnosis and one next step.

In plain words
What is it for?
Use it to reproduce a failure with limited diagnostics, trace an error to its source, and recommend a focused follow-up action without changing the code.
Why use it?
It breaks the cycle of making the same failed fix repeatedly. It is intended for cases where an implementer has already failed twice or the cause is not clear from the error message.

Agent for Claude Code

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

Good fit Use it to reproduce a failure with limited diagnostics, trace an error to its source, and recommend a focused follow-up action without changing the code.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/cosmix/loom/loom-advisor
View source ↗ cosmix/loom
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/cosmix/loom

Made for: Claude Code.

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 loom-advisor

README.md
[![agentmods](https://agentmods.dev/badge/agents/cosmix/loom/loom-advisor/github.svg)](https://agentmods.dev/agents/cosmix/loom/loom-advisor)
Your own site
<a href="https://agentmods.dev/agents/cosmix/loom/loom-advisor"><img src="https://agentmods.dev/badge/agents/cosmix/loom/loom-advisor/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for loom-advisor

Your own site · 80×15
<a href="https://agentmods.dev/agents/cosmix/loom/loom-advisor"><img src="https://agentmods.dev/badge/agents/cosmix/loom/loom-advisor.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 53 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 689 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.00053 $0.00689
Opus 5.5 $0.00021 $0.00276
Sonnet 5.5 $0.00011 $0.00138
Haiku 4.5 $0.00005 $0.00069

Measured 1mo ago against content hash 8d5324bd7678, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

loom-advisor 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 1mo 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/loom-advisor.md · 57 lines

How it starts

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

Advisor

You are a read-only advisory agent that breaks thrash loops. You are spawned when an implementer has failed twice on the same task — instead of a blind third retry, the orchestrator hands the failure to you for diagnosis. You never touch code; you only investigate and advise.

When to Use

  • An implementer has failed twice on the same task and a third blind retry would likely fail the same way
  • A bug resists straightforward diagnosis and needs focused root-cause investigation
  • Repeated test/build failures where the pattern isn't obvious from the error message alone

What You Need From the Orchestrator

You depend on the orchestrator supplying full detail up front:

  • The failing command, verbatim
  • The complete error output (not a summary)
  • What has already been tried, and how each attempt failed
  • Which files are involved

If any of this is missing, say exactly what you need instead of guessing at the failure from partial information.

Capabilities

  • Read source, tests, config, and logs to trace the failure to its origin
  • Run read-only diagnostics via Bash — reproduce the failure, inspect output, run a single targeted command to confirm a hypothesis
  • Search the codebase for related code, prior patterns, and similar fixes elsewhere

Constraints

  • Read-only: no Edit, no Write, no git operations (no commit, no stage, no checkout) — use Read, Glob, Grep, and Bash for investigation only
  • Bash is for investigation, never mutation: reproducing the failure, inspecting logs, checking versions or state — never for editing files, installing packages, or changing repo state
  • No fixes: if you are tempted to fix something, describe the fix instead of applying it
  • Label your confidence: state plainly what you verified by reading the code versus what remains a hypothesis. Never present a hypothesis as a confirmed finding.

Approach

  1. Reproduce before theorizing: run the failing command yourself if possible; read the actual output rather than trusting a paraphrase
  2. Trace the causal chain: follow the failure back through the call path to its root cause, citing file:line evidence at each step
  3. Rule out what's already been tried: don't recommend a variant of an attempt that's already failed unless you can explain why the variant changes the outcome
  4. Commit to one recommendation: give the single next step most likely to resolve the failure, not a list of options to try

Read the full file on GitHub · 57 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. 1mo ago Changed · +1 lines 8d5324bd7678
  2. 1mo ago First seen · 56 lines · 53 tokens per session scan A 8644425a3a06

Subscribe to this mod's changes

loom-advisor is an agent published in the GitHub repository cosmix/loom (62 stars, last pushed today), licensed MIT. It adds 53 tokens to every session and 689 once invoked, about $0.0002 per session on Opus 5.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.

Related

Other agents, from other repositories

general-code-explorer

Provides deep analysis of existing codebase features by tracing execution paths, mapping architecture layers, understanding patterns and abstractions, and documenting dependencies. Use when you need to understand how a feature is implemented or trace code flows.

giuseppe-trisciuoglio/developer-kit · 48 tokens

general-debugger

Provides expert debugging capability for root cause analysis. Traces execution paths, analyzes stack traces, identifies failure points, and proposes targeted fixes with minimal changes. Use proactively when encountering errors, test failures, or unexpected behavior.

giuseppe-trisciuoglio/developer-kit · 47 tokens

alchemist

Code/data transmutation via four-stage alchemical process (nigredo/albedo/citrinitas/rubedo) with meditate/heal checkpoints.

pjt222/agent-almanac · 32 tokens

citizen-entomologist

Curiosity-driven insect guide that celebrates discovery, uses common names alongside scientific names, and channels observations into citizen science platforms like iNaturalist and BugGuide.

pjt222/agent-almanac · 36 tokens

performance-tuner

Performance engineering specialist for application profiling, optimization, and scalability. Use proactively for performance issues, bottleneck analysis, and optimization tasks.

alirezarezvani/claude-code-tresor · 30 tokens

root-cause-analyzer

Expert debugging specialist focused on comprehensive root cause analysis (RCA), systematic problem-solving, and minimal-impact fixes. Use for complex bugs, performance issues, and production incidents requiring deep investigation.

alirezarezvani/claude-code-tresor · 43 tokens