Clodbridge

MCP CI Node.js TypeScript License

MCP server that bridges Cursor's .cursor/ directory into Claude Code.

Define custom rules, skills, and agents in your project. Claude Code automatically discovers and uses them.

---

Quick Navigation

Audience	Document	What You'll Find
Users	HUMANS.md	Quick start, creating rules/skills/agents, best practices, troubleshooting
AI Agents & Developers	AGENTS.md	MCP tools reference, agent spawning, architecture, development guide
Contributors	CONTRIBUTING.md	Testing, build setup, adding file types, code conventions
Security	SECURITY.md	Reporting vulnerabilities, supported versions, security practices

---

What You Get

• Dynamic discovery -- Add a file, it appears instantly
• Agent spawning -- Claude Code offers specialists automatically
• Live reloading -- Changes picked up within 200ms
• Zero config -- Works out of the box
• Type safe -- Full TypeScript strict mode
• Well tested -- 80%+ coverage on core logic

---

Quick Start Example

Create .cursor/rules/my-rule.mdc:

---
name: my-rule
description: Always test new features
alwaysApply: true
---

# My Rule

Add tests when writing new features.

Done! Claude Code will follow this rule automatically.

For more examples and detailed guidance, see HUMANS.md

---

Architecture Overview

• src/reader/ — File discovery, parsing, rule matching
• src/tools/ — MCP tool implementations
• src/resources/ — MCP resource endpoints
• src/server.ts — Server initialization

For the full technical reference, see AGENTS.md

---

File Locations

.cursor/
├── rules/           # Guidelines Claude Code follows (.mdc files)
├── skills/          # Detailed how-to guides (SKILL.md in subdirs)
└── agents/          # Specialized AI assistants (.md files)

Each file is immediately discoverable by Claude Code via the MCP bridge.

---

Pick the guide that fits your role from the navigation table above.