agentsbridge

---

Why

Your team uses Claude Code. Your teammate uses Cursor. Someone just switched to Codex CLI. And suddenly your coding standards live in five different files that silently drift apart:

AGENTS.md                          ← Codex, Gemini CLI, Jules, Amp, Zed read this
CLAUDE.md                          ← Claude Code reads this (not AGENTS.md)
.github/copilot-instructions.md    ← GitHub Copilot reads this (not AGENTS.md)
.cursor/rules/*.mdc                ← Cursor reads this (not AGENTS.md, older versions)
.windsurfrules / .clinerules       ← Windsurf / Cline read these
CONVENTIONS.md                     ← Aider reads this

agentsbridge fixes this with one command. You maintain one AGENTS.md (the emerging industry standard) — it generates and keeps every tool's file in sync. Edit once, sync everywhere, and let CI catch anything that drifts.

Quick start

pipx install agentsbridge        # or: pip install agentsbridge / uv tool install agentsbridge

Already have rules somewhere? Import them:

agentsbridge import              # seeds AGENTS.md from CLAUDE.md, .cursorrules, etc.

Starting fresh?

agentsbridge init                # creates a starter AGENTS.md

Then — the only command you'll ever need again:

agentsbridge sync

  + created   CLAUDE.md
  + created   .github/copilot-instructions.md
  + created   .cursor/rules/agentsbridge.mdc
  + created   .windsurfrules
  + created   .clinerules
  + created   CONVENTIONS.md
  + created   .roo/rules/agentsbridge.md
  + created   .kilocode/rules/agentsbridge.md
  + created   .junie/guidelines.md
  + created   .amazonq/rules/agentsbridge.md
  + created   GEMINI.md

wrote 11 file(s)

Edit AGENTS.md, run agentsbridge sync, commit. That's the whole workflow.

Supported tools

Run agentsbridge list to see this table in your terminal.

Missing a tool? Open an issue — adding a target is ~10 lines.

Safety

Generated files are marked:

<!-- generated by agentsbridge; do not edit -->

If a target file already exists without that marker (i.e. you wrote it by hand), sync skips it instead of clobbering your work. Use --force to adopt it deliberately.

agentsbridge sync --force        # adopt existing files
agentsbridge sync --dry-run      # preview changes
agentsbridge sync -t claude,copilot   # subset of targets

Tip: set AGENTSBRIDGE_TARGETS=claude,copilot in your environment (e.g. CI) to pin a subset without repeating -t on every invocation. Explicit -t always wins over the env var.

CI drift check

The whole point: rules that drift are rules nobody follows. Add the check to your workflow and CI fails whenever someone edits a generated file — or forgets to re-sync after editing AGENTS.md:

# .github/workflows/ci.yml
name: rules
on: [push, pull_request]
jobs:
  agentsbridge:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: DavidStarYu/agentsbridge/action@main

Or invoke the CLI directly: agentsbridge check (exit code 1 on drift).

This repository runs the same check on itself — dogfooding.

FAQ

Why AGENTS.md as the source, not my own config? AGENTS.md is the emerging standard (adopted by OpenAI Codex, Gemini CLI, Jules, Amp, Zed and others — see agents.md). Tools that don't read it yet are exactly the ones this bridge targets. You keep zero agentsbridge-specific config: the source file is a standard.

Cursor already reads AGENTS.md, why generate an .mdc? Newer Cursor versions read AGENTS.md directly; many teams run versions that don't, or want explicit rule scoping. The generated .mdc is harmless if redundant — and you can exclude it: agentsbridge sync -t claude,copilot,....

Does it send my code anywhere? No. No network calls, no telemetry, no API keys. It's a template engine over one markdown file. Zero dependencies.

How is this different from X? rulesync (Node.js) covers more features — MCP servers, subagents, commands — at the cost of a bigger footprint and a .rulesync/ directory convention. agentsbridge does one thing: keep rule files in sync, in pure Python with zero dependencies. If you live in pipx/uv and want the simple thing, this is for you.

Development

git clone https://github.com/DavidStarYu/agentsbridge
cd agentsbridge
pip install -e . pytest ruff
pytest            # 47 tests
ruff check .

License

MIT