Skip to content

README.md

Latest commit

 

History

History
83 lines (56 loc) · 2.67 KB

README.md

File metadata and controls

83 lines (56 loc) · 2.67 KB

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.