mcp-chrome-debugger-protocol: Instructions file for Codex

AGENTS.md

mcp-chrome-debugger-protocol AGENTS.md is an instructions file for Codex, OpenCode from VitalyOstanin/mcp-chrome-debugger-protocol. It costs 1,601 tokens per session, scanned A, original, MIT.

Repository instructions for an MCP server that connects coding agents to Chrome debugging tools. MCP is a standard way for software to expose tools to an AI agent, while the server uses TypeScript, the Chrome DevTools Protocol, and tests.

In plain words
What is it for?
Use them when developing the MCP server, its debugger or transport modules, source-map handling, unit tests, integration tests, or build and lint tasks.
Why use it?
They show where the main modules and tests live and list the commands for building, running, checking, and testing the project. This gives contributors a consistent workflow and coding standard.

Instructions file for CodexOpenCode

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

This is VitalyOstanin/mcp-chrome-debugger-protocol's own configuration. It tells Codex and OpenCode how to work on mcp-chrome-debugger-protocol 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 mcp-chrome-debugger-protocol configures →

Reuse

Borrowing it

Nothing to install: this file belongs to VitalyOstanin/mcp-chrome-debugger-protocol. 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/VitalyOstanin/mcp-chrome-debugger-protocol/master/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/VitalyOstanin/mcp-chrome-debugger-protocol

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 mcp-chrome-debugger-protocol AGENTS.md

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/vitalyostanin/mcp-chrome-debugger-protocol/agents-md"><img src="https://agentmods.dev/badge/instructions/vitalyostanin/mcp-chrome-debugger-protocol/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,601 This file is loaded in full into every session.
When invoked 1,601 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.01601 $0.01601
Opus 5 $0.00800 $0.00800
Sonnet 5 $0.00320 $0.00320
Haiku 4.5 $0.00160 $0.00160

Measured 8d ago against content hash 3e22fc0bc958, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

mcp-chrome-debugger-protocol 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 8d 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 · 91 lines

How it starts

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

Repository Guidelines

Contributor Notes

  • Read CLAUDE.md first for project-specific rules and workflow.
  • Project language: English (code, comments, docs, commits).
  • After making changes, run npm run lint:fix locally before commits.

Project Structure & Module Organization

  • src/: TypeScript sources for the MCP server, DAP client, CDP transport, and utilities.
    • Key modules: mcp-server.ts, dap-client.ts, nodejs-debug-adapter.ts, cdp-transport.ts, source-map-resolver.ts.
  • tests/: vitest tests (unit in src/ next to source, integration under tests/integration/), with fixtures in tests/fixtures/.
  • dist/: Compiled JS (generated by npm run build).
  • scripts/: Local helper scripts (dev-test.sh, mcp-logpoint-check.mjs).

Build, Test, and Development Commands

  • npm run build: Compile TypeScript to dist/ (runs prebuild clean step first).
  • npm start: Run compiled server from dist/index.js.
  • npm run dev: Type-check/watch compile during development.
  • npm run dev:server: Build then start the server.
  • npm test: Run unit tests (vitest.config.ts).
  • npm run test:integration: Run integration tests (vitest.integration.config.ts).
  • npm run test:all: Run unit and integration tests sequentially.
  • npm run lint / npm run lint:fix: Lint and auto-fix code style.
  • npm run dev:test: Dev helper script that launches the test-app fixture under --inspect=9229 for manual attach.

Coding Style & Naming Conventions

  • Language: TypeScript (ES modules). Files use kebab-case (e.g., dap-client.ts).
  • Linting: ESLint (see eslint.config.mjs). Use nullish coalescing (??), optional chaining (?.).
  • Blank lines: required before return, before/after a block of const/let/var; never between adjacent declarations.
  • Prefer const, modern ES syntax, and type-only imports/exports where appropriate.

Testing Guidelines

  • Framework: vitest (vitest.config.ts for unit, vitest.integration.config.ts for integration). Keep tests near related features under tests/integration/ or src/*.test.ts.
  • Naming: *.test.ts with descriptive, behavior-focused test names.
  • Run full suite locally (npm run test:all) before opening PRs.
  • After substantial changes: run integration tests selectively for affected specs to iterate faster, for example:
    • npm run test:integration -- tests/integration/your-feature.test.ts
    • npm run test:integration -- -t "your test name pattern"
    • npm run test:integration -- --reporter=verbose
  • If no tests cover the change (new functionality), propose creating a new integration or unit test and add it alongside the feature.
  • Resource limits in vitest*.config.ts (maxWorkers: '10%' for unit, maxWorkers: 1 + fileParallelism: false for integration) are intentional. Do not raise them.

Read the full file on GitHub · 91 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. 8d ago First seen · 91 lines · 1,601 tokens per session scan A 3e22fc0bc958

Subscribe to this mod's changes

mcp-chrome-debugger-protocol AGENTS.md is an instructions file published in the GitHub repository VitalyOstanin/mcp-chrome-debugger-protocol (2 stars, last pushed yesterday), licensed MIT. It adds 1,601 tokens to every session, about $0.0080 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 instructions, from other repositories

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens