cli-bridge-mcp AGENTS.md

cli-bridge-mcp AGENTS.md is an instructions file for Codex, OpenCode from JoaoBerne/cli-bridge-mcp. It costs 2,520 tokens per session, scanned A, original, Apache-2.0.

A contributor guide for an MCP server that runs official command-line interfaces from other AI systems as separate review lanes. MCP, or Model Context Protocol, is a standard way for an AI host to call tools provided by another program.

In plain words
What is it for?
Use it when changing the server, adding or reviewing AI-CLI lanes, updating tool schemas or prompts, or working with its configuration and review-result formats.
Why use it?
It explains the repository structure and keeps the server’s tool dispatch, compatibility code, schemas, prompts, resources, and subprocess execution organized. The server is read-only by default and does not extract tokens or API keys.

Instructions file for CodexOpenCode

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/joaoberne/cli-bridge-mcp/agents-md
Clone the repo
git clone --depth 1 https://github.com/JoaoBerne/cli-bridge-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 cli-bridge-mcp AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/joaoberne/cli-bridge-mcp/agents-md.svg)](https://agentmods.dev/instructions/joaoberne/cli-bridge-mcp/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/joaoberne/cli-bridge-mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/joaoberne/cli-bridge-mcp/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 2,520 This file is loaded in full into every session.
When invoked 2,520 The same file — it is already loaded in full.
Security scan A 1 finding. 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.02520 $0.02520
Opus 5 $0.01260 $0.01260
Sonnet 5 $0.00504 $0.00504
Haiku 4.5 $0.00252 $0.00252

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

Security

Grade A, and why

cli-bridge-mcp AGENTS.md scanned grade A with 1 finding 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 4d 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

bridges/ # bundled stdlib API bridges (openai_compatible.py = cli-bridge-openai, urllib-only)
AGENTS.md · 141 lines

How it starts

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

Agent guide — cli-bridge

Guidance for AI coding agents (Claude Code, Codex, Gemini CLI, opencode…) working on this repo. CLAUDE.md is a symlink to this file.

What this is

An MCP server that lets the host AI consult other AI CLIs as a council. Each lane spawns the official CLI as a subprocess (ban-safe: no token extraction, no API keys). Read-only by default. Pure-stdlib + mcp only.

Layout

src/cli_bridge/
  server.py     # MCP surface: handlers, call_tool dispatch, hot path (_run_lane), request-context glue. Keep thin.
  mcp_compat.py # the ONLY file that branches on the mcp SDK major (1.x decorators vs 2.x add_request_handler, renamed fields)
  schemas.py    # tool-schema assembly (_tools_for/_ask_schema/_filter_tools) — pure, re-exported by server
  reports.py    # doctor/doctor_deep + _render_* markdown + setup recommendation (injected is_host/run_lane)
  prompts.py    # MCP prompt builders + _PROMPTS registry (host-native slash commands, pure)
  resources.py  # MCP resource payloads: config snapshot + review-result JSON schema (pure)
  lanes.py      # LaneSpec registry + argv builders + custom-lane JSON loader
  runner.py     # subprocess exec, redaction, process-tree kill, error classification
  config.py     # env parsing, cost profile, timeouts, onboarding text
  telemetry.py  # sqlite3 run log + lane health/cooldown (best-effort, privacy-first)
  router.py     # deterministic cascade ordering (pure)
  council.py    # ask_all/ask_cascade/ask_best/synthesize fan-out (injected run_lane — like workflows)
  jobs.py       # in-process async jobs (ask_all_async) + sqlite persistence
  workflows.py  # review_diff/security_review/debate + prechecks + council recap
  orchestrate.py # batch_run durable fan-out + presets (refine_plan/verify_repair/fanout_compare/converge)
  consensus_loop.py # converge-loop PURE state machine (3 governance guards, no I/O) — driven by orchestrate
  findings.py   # parse/merge/render structured review findings (pure; optional category taxonomy)
  guards.py     # injection/tool-poisoning output guard (CLI_BRIDGE_GUARD)
  worktrees.py  # ask_build (isolated worktree diff | direct zone-guarded write + artifact return)
  buildloop.py  # steerable multi-turn builds: job_tail/build_steer, executable DoD gate
  conversations.py # round-table threads: sqlite persistence + recipient-aware replay
  preamble.py   # terse response-style preamble prepended to delegate prompts
  eval.py       # quality eval: council vs single + self-consistency, permutation test, scorer
  cli.py        # human/CI entry point (cli-bridge ...) over the same internals
  detect.py     # PATH detection (+ availability_env gate for opt-in API lanes)
  bridges/      # bundled stdlib API bridges (openai_compatible.py = cli-bridge-openai, urllib-only)
tests/          # pytest; unit + cross-host integration (no real CLI needed)
docs/           # COSTS.md, BENCHMARKS.md, ARCHITECTURE.md, i18n/ READMEs
assets/         # README banner/mark/social SVGs + demo.gif (generated, do not hand-edit)
site/           # GitHub Pages landing (deployed by .github/workflows/pages.yml)
examples/       # custom-lane JSON recipes + GitHub Action

Read the full file on GitHub · 141 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. 4d ago First seen · 141 lines · 2,520 tokens per session scan A b53c476dfb9c

Subscribe to this mod's changes

cli-bridge-mcp AGENTS.md is an instructions file published in the GitHub repository JoaoBerne/cli-bridge-mcp (2 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 2,520 tokens to every session, about $0.0126 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). 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

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

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

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,182 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,345 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

next.js 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