agentmods.dev

vibe-debug AGENTS.md

A Python debugging guide for cases where a bug can be reproduced with a script, test, command, or request. It tells the agent to inspect the program while it is running, including the values held at the failure point.

In plain words
What is it for?
Use it to investigate reproducible Python failures, inspect local variables and runtime state, evaluate read-style expressions, and report observed values.
Why use it?
It reduces guesswork when source code alone cannot show which branch, input, or variable caused the problem.

Instructions file for CodexOpenCode

27 3mo ago A scan 215 tokens original MIT
View the source file illscience/vibe-debug
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 instructions/illscience/vibe-debug/agents-md
Clone the repo
git clone --depth 1 https://github.com/illscience/vibe-debug

Made for: Codex, OpenCode.

Per session 215 This file is loaded in full into every session.
When invoked 215 The same file — it is already loaded in full.
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.00215 $0.00215
Opus 5 $0.00108 $0.00108
Sonnet 5 $0.00043 $0.00043
Haiku 4.5 $0.00021 $0.00021

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

Security

Grade A, and why

vibe-debug AGENTS.md 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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 18 lines

What it actually says

Debugging Workflow

When a Python bug has a reproducible script, test, command, or request, prefer observing live runtime state before proposing a fix.

Use the vibe-debug skill or CLI when:

  • the failure depends on branches, inputs, object state, or local variables;
  • source reading suggests multiple possible causes;
  • you are about to infer a variable value that can be observed directly.

Recommended workflow:

  1. Use the vibe-debug skill if it is available in this project.
  2. Run npx -y github:illscience/vibe-debug debug-python <script.py> --break <file.py>:<line> --json.
  3. Inspect the stopped location, locals, and evaluations.
  4. Use --eval only for read-style expressions; it can execute code in the debuggee.
  5. If an MCP server named vibe-debug is installed, debug_python_repro is also acceptable.

When reporting a bug, include the runtime values you observed and distinguish them from source-code inference.

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 · 18 lines · 215 tokens per session scan A cfc2691b9f9e

Subscribe to this mod's changes

vibe-debug AGENTS.md is an instructions file published in the GitHub repository illscience/vibe-debug (27 stars, last pushed 3mo ago), licensed MIT. It adds 215 tokens to every session, about $0.0011 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.

DebuggingResearchTestingclaude-codecodexcoding-agentsdapdebuggerdebugpy
Related

Other instructions, from other repositories

debugium CLAUDE.md

Claude Code instructions for Algiras/debugium, covering debugium — claude code instructions, setup, 1. install debugium, 2. register the mcp server and 3. launch a debug session.

Algiras/debugium · 2,471 tokens

ontology-atlas AGENTS.md

Instructions for wlsdks/ontology-atlas, covering agents.md — ontology-atlas, product and non-negotiable architecture, start here, structure and routes and operating gates and skills.

wlsdks/ontology-atlas · 2,685 tokens

ephemeral-sandbox CLAUDE.md

Instructions for Ephemeral-AI-Lab/ephemeral-sandbox, covering claude.md, project, engineering practice (required), build & test and sandbox tools.

Ephemeral-AI-Lab/ephemeral-sandbox · 1,203 tokens

matt-skills-with-to-goal CLAUDE.md

Instructions for tt-a1i/matt-skills-with-to-goal: Skills are organized into bucket folders under skills/.

tt-a1i/matt-skills-with-to-goal · 989 tokens

coral CLAUDE.md

Instructions for cdknorow/coral, covering claude.md - coral go, mission, testing, go unit tests and legacy parity tools (historical reference).

cdknorow/coral · 1,898 tokens

pixir CLAUDE.md

Instructions for Ranvier-Technologies/pixir, covering pixir harness - legacy agent guide, current map and commands.

Ranvier-Technologies/pixir · 246 tokens