What is central-mcp CLAUDE.md?

Contributor instructions for central-mcp, a Python command-line tool and MCP server that sends work to coding-agent command-line programs across registered projects. MCP is a standard way for AI tools to access external capabilities.

Use them when modifying central-mcp's Python code, command-line interface, project layout, tests, release process, or dispatch logging.

They distinguish source-code development instructions from the separate runtime instructions used by the dispatch service.

central-mcp CLAUDE.md — Instructions file for coding agents by andy5090: Contributor instructions for central-mcp, a Python command-line too

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/andy5090/central-mcp/claude-md

Clone the repo

git clone --depth 1 https://github.com/andy5090/central-mcp

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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/andy5090/central-mcp/claude-md.svg)](https://agentmods.dev/instructions/andy5090/central-mcp/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/andy5090/central-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/andy5090/central-mcp/claude-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 1,827 This file is loaded in full into every session.

When invoked 1,827 The same file — it is already loaded in full.

Security scan C 1 finding. Scan, not verified.

Origin 88% copy Near-identical to another mod 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.

Model	Per session	Once invoked
Fable 5	$0.01827	$0.01827
Opus 5	$0.00914	$0.00914
Sonnet 5	$0.00365	$0.00365
Haiku 4.5	$0.00183	$0.00183

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

Security

Grade C, and why

central-mcp CLAUDE.md scanned grade C 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.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

5. `rm -rf dist && uv build`.

Origin

This is a copy

88% identical to central-mcp AGENTS.md — 4 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 86 lines

How it starts

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

central-mcp — development guide

You are working on the central-mcp codebase itself. This file is for contributors (human or agent) editing the source tree. The runtime orchestrator instructions — the ones that describe how dispatch / check_dispatch should be used and what the observation layer does — live separately in src/central_mcp/data/{CLAUDE,AGENTS}.md and get copied to ~/.central-mcp/ on first launch. Don't confuse the two roles:

File path	Role	Audience
`src/central_mcp/data/{CLAUDE,AGENTS}.md`	Runtime, shipped with the wheel	Orchestrator agent running inside a user's `~/.central-mcp/` session
`/{CLAUDE,AGENTS}.md` (repo root)	Dev-mode, NOT shipped	Anyone editing central-mcp's source

What central-mcp is

A Python MCP server + CLI that acts as an orchestrator-agnostic dispatch hub across a user's registered projects. Each project is associated with a coding-agent CLI (claude / codex / gemini / droid / opencode). Dispatches are non-blocking subprocesses in the project's cwd; results stream to ~/.central-mcp/logs/<project>/dispatch.jsonl and can be tailed via central-mcp watch <project>.

Primary surfaces:

MCP tools (dispatch, check_dispatch, list_projects, orchestration_history, reorder_projects, …) — defined in src/central_mcp/server.py.
CLI subcommands (run, up, tmux, zellij, down, watch, upgrade, add, remove, list, brief, install, alias, unalias, reorder, init, serve) — wired in src/central_mcp/cli/__init__.py, implementation in src/central_mcp/cli/_commands.py.

Repo layout

src/central_mcp/
  cli/
    __init__.py       argparse + entry point (`central-mcp`, `cmcp`)
    _commands.py      cmd_* handlers + shared helpers
  adapters/base.py    per-agent launch / session-list logic
  server.py           MCP tool definitions (stdio)
  registry.py         registry.yaml load / save / reorder
  layout.py           tmux multi-pane layout builder
  zellij.py           zellij KDL layout builder
  grid.py             shared terminal-size-derived pane math (tmux + zellij)
  watch.py            `central-mcp watch` jsonl streamer
  session_info.py     which-multiplexer-is-active stamp
  paths.py            $CENTRAL_MCP_HOME resolution cascade
  data/
    CLAUDE.md         RUNTIME orchestrator guideline (shipped)
    AGENTS.md         RUNTIME orchestrator guideline (shipped)
tests/                pytest suite (run: `uv run --no-sync pytest`)
docs/
  ROADMAP.md          phases / intent
  architecture/       deeper dives (gemini session storage, etc.)
CHANGELOG.md          Keep-a-Changelog; top block = unreleased when in-flight
pyproject.toml        `version = "X.Y.Z"` (hatchling)
README.md / README_KO.md  user-facing docs; absolute image URLs so PyPI renders them

Read the full file on GitHub · 86 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.

4d ago First seen · 86 lines · 1,827 tokens per session scan C 51a750ef61b3

Subscribe to this mod's changes

central-mcp CLAUDE.md is an instructions file published in the GitHub repository andy5090/central-mcp (5 stars, last pushed 24d ago), licensed MIT. It adds 1,827 tokens to every session, about $0.0091 per session on Opus 5. A static security scan graded it C with 1 finding (recursive force delete). It is 88% identical to central-mcp AGENTS.md, differing in 4 lines, and is treated as a copy.

Building agents Git and workflow Orchestration Releases agent-agnostic centralized-management mulit-project parallel-agents parallelism

central-mcp CLAUDE.md

Getting it into your agent

Wrote this? Show the measurements

What it costs to keep this loaded

Grade C, and why

Recursive force deletehighDestructive command

This is a copy

How it starts

central-mcp — development guide

What central-mcp is

Repo layout

What this file has done since we first saw it

Other instructions, from other repositories

franke_skills AGENTS.md

good-bad-ugly AGENTS.md

planning-with-files AGENTS.md

workflow AGENTS.md

openrouter-mcp-multimodal AGENTS.md

OpenMicro AGENTS.md