Generates .traerules workspace rules for ByteDance's Trae AI IDE.
Synchronizes workspace rules and architecture to .windsurfrules for Codeium/Windsurf IDE.
Generates .github/copilot-instructions.md with repository-level guidelines and security constraints for GitHub Copilot.
Generates modular workspace rules under .gemini/antigravity/rules/ for Google Antigravity agents, enabling architecture and planning handoffs.
One context. Every AI coding tool. Zero copy-paste.
You use Cursor at work, Claude Code in the terminal, Copilot in pull requests, and three CLI agents on CI. Each one wants its own instruction file. So you maintain four copies of the same rules, they drift, and no agent knows what the others did yesterday.
Related MCP server: passoff
Keep the rules once, in .syncytium/, and transpile them into every
tool's native format.
.syncytium/ canonical, human-authored, git-tracked
rules/*.md code style, security, testing, architecture, …
memory/decisions.md ADRs — why the project is the way it is
HANDOFF.md live agent baton: who has it, what's next
│
│ syncytium sync
â–¼
CLAUDE.md AGENTS.md GEMINI.md AGENT.md CONVENTIONS.md
.cursorrules .clinerules .roomodes .windsurfrules .traerules
.cursor/rules/*.mdc .gemini/antigravity/rules/*.md
.github/copilot-instructions.md + .github/instructions/*.instructions.mdEvery generated file carries a banner saying where it came from, and
syncytium diff --check fails your CI if any of them drift. syncytium clean
removes only banner-tagged files — your hand-written rules are never touched.
npx syncytium init # scaffold .syncytium/ (stack auto-detected)
npx syncytium sync # generate every bridge file
npx syncytium graph # open the 3D knowledge graph in your browserRequires Node.js 22.6+. No global install needed; npx works.
10 built-in adapters | Cursor, Claude Code, GitHub Copilot, Cline/Roo, Antigravity, Windsurf, Trae, OpenCode, AGENTS.md, GEMINI.md |
Stack-aware starters | TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, PHP, Ruby, .NET, Swift, Elixir, generic |
Multi-agent safety | A lease-based workspace lock with heartbeat, a handoff baton, and a 100-entry audit trail |
Drift detection | Real unified diffs, orphan detection, and a |
Live 3D graph | WebGL knowledge cosmos, vault explorer, Markdown document reader — bound to |
MCP server | 18 tools with zod-validated inputs and token-budgeted output |
CI + git hooks |
|
| Every command emits machine-readable output for agents and CI |
Run syncytium --help for the full list.
Command | What it does |
| Scaffold |
| Regenerate all bridge files. |
| Auto-sync on every change. |
| Show drift with real patches. |
| 11 health checks, each with an actionable |
| Validate rules, frontmatter and ADR schema. |
| Validate |
| Delete only banner-tagged files. |
| One portable Markdown bundle you can paste anywhere. |
| Reverse-migrate existing |
| List every registered adapter and its targets |
| One-screen project + handoff + lock summary |
syncytium rules [query] # search the catalog
syncytium rule add --title "..." --body "..." # add a canonical rule
syncytium rule show <id> # inspect one
syncytium rule update <id> --body-file x.md # edit in place
syncytium rule remove <id> # delete + prune generated files
syncytium adr list # architectural decisions
syncytium adr add --title "..." --context "..." \
--decision "..." --consequences "..."
syncytium adr show ADR-006
syncytium adr remove ADR-006syncytium lock acquire --agent "Cursor" --goal "Refactor auth"
syncytium lock heartbeat --agent "Cursor" # extend the lease
syncytium lock status
syncytium lock release --agent "Cursor"
syncytium handoff -i # interactive wizard
syncytium handoff --from "Cursor" --to "Claude" \
-s ready_for_review -g "Ship v1" -d "…" -t "…"
syncytium log -n 20 # baton audit trailsyncytium hook install # block commits on drift
syncytium hook install --auto-sync # or just re-sync on every commit
syncytium ci # .github/workflows/syncytium.yml drift gate
syncytium ci --force # regenerate an existing workflowsyncytium graph # 3D WebGL cosmos + vault explorer
syncytium graph --category ide # isolate IDE adapters
syncytium graph --compact # hide file and tag nodes
syncytium graph --no-open --port 4000The server binds to 127.0.0.1 and rejects non-loopback Host headers
(DNS-rebinding guard). It refuses to serve .env*, *.pem, *.key, .git/**
and other in-root secrets.
{
"mcpServers": {
"syncytium": {
"command": "npx",
"args": ["-y", "syncytium-mcp"],
"cwd": "${workspaceFolder}"
}
}
}Or syncytium mcp if you already have the CLI installed. Tools include
syncytium_get_context, syncytium_handoff, syncytium_create_rule,
syncytium_update_rule, syncytium_remove_rule, syncytium_record_decision,
syncytium_sync, syncytium_diff, syncytium_doctor, syncytium_validate,
syncytium_lock_acquire/release/status, syncytium_get_graph and more.
Every input is zod-validated; every output is summarised rather than dumped.
.syncytiumignoreExcludes generated targets from both sync and diff. Full gitignore syntax,
including **, ?, directory-only patterns and ! negation:
# Don't manage these tools
.cursorrules
.github/instructions/
# Except this one
!.github/instructions/keep.mdDeclare any tool in syncytium.config.json — no code required:
{
"customAdapters": [
{
"id": "zed",
"name": "Zed",
"targetFile": ".rules/zed.md",
"includeHandoff": true,
"includeArchitecture": true
}
],
"enabledAdapters": ["cursor", "claude", "zed"]
}import { SyncytiumEngine } from 'syncytium-md';
const engine = new SyncytiumEngine(process.cwd());
await engine.sync();
const { hasDrift, summary } = await engine.diff();
const graph = await engine.getKnowledgeGraph({ category: 'ide' });npm install
npm run verify # typecheck -> build -> 114 testsSee CONTRIBUTING.md and
.syncytium/architecture.md.
MIT © Miraç Birben
Shared memory for AI coding agents. Save once, reuse from Cursor, Claude Code, Codex.
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
One identity across Claude Code, Codex, Cursor, Gemini, Windsurf: shared inbox and handoffs.
Shared memory for coding agents. Stop re-explaining your codebase every session.
