debug-recorder-mcp: Instructions file for Codex

AGENTS.md

debug-recorder-mcp AGENTS.md is an instructions file for Codex, OpenCode from oaslananka/debug-recorder-mcp. It costs 1,594 tokens per session, scanned A, original, MIT.

A set of development instructions for a TypeScript server that records structured debugging sessions and diagnostic events.

In plain words
What is it for?
Use it when developing, testing, or maintaining the debug-recorder-mcp project.
Why use it?
It gives coding agents project-specific rules and checks to follow when changing that repository.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions AGENTS.md.

This is oaslananka/debug-recorder-mcp's own configuration. It tells Codex and OpenCode how to work on debug-recorder-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything debug-recorder-mcp configures →

Reuse

Borrowing it

Nothing to install: this file belongs to oaslananka/debug-recorder-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/oaslananka/debug-recorder-mcp/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/oaslananka/debug-recorder-mcp

Made for: Codex, OpenCode.

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

README.md
[![agentmods](https://agentmods.dev/badge/instructions/oaslananka/debug-recorder-mcp/agents-md/github.svg)](https://agentmods.dev/instructions/oaslananka/debug-recorder-mcp/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/oaslananka/debug-recorder-mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/oaslananka/debug-recorder-mcp/agents-md/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 debug-recorder-mcp AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/oaslananka/debug-recorder-mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/oaslananka/debug-recorder-mcp/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,594 This file is loaded in full into every session.
When invoked 1,594 The same file — it is already loaded in full.
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.01594 $0.01594
Opus 5.5 $0.00638 $0.00638
Sonnet 5.5 $0.00319 $0.00319
Haiku 4.5 $0.00159 $0.00159

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

Security

Grade A, and why

debug-recorder-mcp 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 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.md · 96 lines

How it starts

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

You are a senior software engineer.

WORKING PRINCIPLES:

[ENVIRONMENT — BEFORE STARTING THE TASK]

  1. Detect the operating system:
    • Linux/macOS: uname -s && echo $SHELL && node --version
    • Windows: $env:OS && $PSVersionTable.PSVersion && node --version
  2. Confirm required tools are available (git, node, npm, optional python/pip).
  3. Check whether AGENTS.md exists. If it does, read it and follow its rules.
  4. Check whether README.md exists. If it does, read it.

[PIN LIBRARIES]

Before writing code, research current stable versions and update the approved table.

Approved Dependencies

Package Version Why
@modelcontextprotocol/sdk 1.29.0 Current stable release on the MCP SDK v1.x line as of April 2026.
better-sqlite3 12.8.0 Current stable native SQLite release compatible with the supported Node 22 and Node 24 LTS lines.
fuse.js 7.3.0 Current stable Fuse.js release compatible with the existing fuzzy search API.
zod 3.25.76 Stable patch release that satisfies the 3.25+ requirement and behaves well with TypeScript inference.
eslint 9.39.4 Current stable release on the ESLint 9 maintenance line, selected for flat config migration.
@eslint/js 9.39.4 Kept on the same maintenance line as ESLint 9 flat config.
@typescript-eslint/eslint-plugin 8.58.1 Current stable plugin release compatible with ESLint 9 and TypeScript 5.9.
@typescript-eslint/parser 8.58.1 Parser release compatible with ESLint 9 and TypeScript 5.9.
typescript 5.9.3 Current TypeScript 5.9 patch line for the conservative quality pass.
@types/node 22.19.17 Stable Node type line for the Node 22 support floor while runtime CI also covers Node 24 LTS.
globals 17.4.0 Required to define environment globals explicitly in ESLint flat config.
ts-node 10.9.2 Required helper tool for npm run dev.
@jest/globals 30.4.1 Current stable explicit Jest globals package used by TypeScript test imports.
@types/jest 30.0.0 Current stable Jest type package aligned with the Jest 30 test runtime.
jest 30.4.2 Current stable Jest release used to keep the test runner on the maintained major line.
jest-junit 17.0.0 Current stable release with patched uuid transitive dependency, required to publish Azure DevOps test results as JUnit XML.
ts-jest 29.4.11 Current stable transformer release compatible with Jest 30 and TypeScript 5.9.
fast-check 4.8.0 Current stable property-based testing release for Jest-compatible TypeScript fuzz/regression tests.
knip 6.14.2 Current stable dead-code and dependency checker compatible with the supported Node 22 and Node 24 LTS lines.
babel-plugin-istanbul 8.0.0 Current stable coverage instrumentation plugin used through overrides to avoid deprecated transitive glob paths.
glob 13.0.6 Current stable glob release used through overrides to keep Jest coverage tooling off deprecated glob versions.
test-exclude 8.0.0 Current stable coverage exclusion helper compatible with babel-plugin-istanbul 8 and glob 13.
typedoc 0.28.18 API documentation generator compatible with TypeScript 5.9.
typedoc-plugin-markdown 4.12.0 Selected to generate TypeDoc output as Markdown under docs/api.
@humanfs/core 0.20.0 Override to fix moderate vulnerability GHSA-p498-v437-472g in transitive dependency.
@humanfs/node 0.17.0 Override to fix moderate vulnerability GHSA-p498-v437-472g in transitive dependency (Node 24+).
@humanfs/types 0.16.0 Type definitions for @humanfs/core and @humanfs/node.
baseline-browser-mapping 2.11.27 Override to fix moderate vulnerability GHSA-w5vr-8v7q-w6rv in transitive dependency.
browserslist 4.29.3 Override to fix high vulnerability GHSA-c83g-rgw3-j3cx in transitive dependency.
proxy-addr 2.0.8 Override to fix critical vulnerability GHSA-jqcg-44mw-7w3h in transitive dependency.
qs 6.16.0 Override to fix moderate vulnerability GHSA-x5fp-wj9c-mxmx in transitive dependency.
smol-toml 1.9.0 Override to fix moderate vulnerability GHSA-7w5x-hrqm-74c2 in transitive dependency.

Read the full file on GitHub · 96 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 · +8 lines · +302 tokens per session 29c833613351
  2. 2mo ago First seen · 88 lines · 1,292 tokens per session scan A 9df7b98523fe

Subscribe to this mod's changes

debug-recorder-mcp AGENTS.md is an instructions file published in the GitHub repository oaslananka/debug-recorder-mcp (2 stars, last pushed 16d ago), licensed MIT. It adds 1,594 tokens to every session, about $0.0064 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-31.

Related

debug-recorder-mcp AGENTS.md compared with instructions from other repositories

debug-recorder-mcp AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
debug-recorder-mcp AGENTS.mdoaslananka/debug-recorder-mcpInstructions file216d agoMITA1,594Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA9,719GitHub Copilot
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA5,516GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA3,093GitHub Copilot
vscode model-prompts.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA2,022GitHub Copilot