v0.1 — early

agentcontext

One source of truth for the agent-context format zoo. Maintain AGENTS.md once, sync everything else.

Why

Every AI coding tool invented its own rules-file format. CLAUDE.md, AGENTS.md, GEMINI.md, .cursor/rules/*.mdc, .cursorrules, .windsurf/rules/*.md, .windsurfrules, .clinerules/*.md, CONVENTIONS.md. Maintaining them by hand drifts. This tool keeps them in sync.

Install

npx @mbeato/agentcontext inspect

No install step. Runs against the current directory and prints a summary.

Try it

Paste a CLAUDE.md, .cursorrules, or any agent-context file. We'll normalize it to AGENTS.md.

Source: →

(output appears here)

How it works

Detects all 10 agent-context formats in a repo, parses each into a unified IR (rules + activation modes + scope), then renders to whichever target you ask for. Round-trip is byte-identical for lossless pairs and bounded-diff for lossy ones.

Format	What we do with it
`AGENTS.md`	Canonical hub. Read + write.
`CLAUDE.md`	Read (with @-import resolution) + write.
`GEMINI.md`	Read (code-block-aware @-imports) + write.
`.cursor/rules/*.mdc`	Read all 4 activation modes + write.
`.cursorrules`	Read only (deprecated by Cursor in Agent mode).
`.windsurf/rules/*.md`	Read all triggers + write (with 12K char-limit warnings).
`.windsurfrules`	Read only (legacy pre-Wave-8).
`.clinerules/*.md`	Read (skips reserved subdirs) + write (numeric prefixes).
`CONVENTIONS.md`	Read + write + emits an `.aider.conf.yml` snippet.
`.aider.conf.yml`	Read `read:` list only — never round-tripped.

From an MCP-aware agent

{
  "mcpServers": {
    "agentcontext": {
      "command": "npx",
      "args": ["-y", "@mbeato/agentcontext-mcp"]
    }
  }
}

Two tools: read_agent_context(path) returns the IR, convert_agent_context(ir, targets) renders to a file map.

CLI

# Show what's in this repo
npx @mbeato/agentcontext inspect

# Detect everything, normalize to AGENTS.md, write per-tool shims
npx @mbeato/agentcontext sync --write --shims claude,cursor,cline

# Explicit one-direction conversion
npx @mbeato/agentcontext convert --from cursor-mdc --to agents-md --in .cursor/rules/style.mdc

Notify me

A GitHub App version is on the roadmap (auto-sync rules across all your repos). Drop your email if you want a heads-up when it lands.