cursor-compose

Auto-detect your project's stack and generate Cursor project rules in one command. No cloning required.

npx cursor-compose

Writes .cursor/rules/project.mdc — the current Cursor format. Legacy .cursorrules also supported.

What it does

1. Scans your project for package.json, requirements.txt, pubspec.yaml, etc.
2. Shows which modules were detected, lets you toggle extras
3. Writes a composed .cursor/rules/project.mdc to your project root

Detected stacks

| File found | Modules added | |-----------|--------------| | next in package.json | nextjs + typescript | | typescript in package.json | typescript | | @supabase/supabase-js | supabase | | drizzle-orm | drizzle | | shadcn / @radix-ui | shadcn | | fastapi in requirements.txt | fastapi | | flutter: in pubspec.yaml | flutter |

core is always included.

Optional modules

Select these manually during init:

• saas — multi-tenancy, billing, feature flags
• ecommerce — cart, checkout, inventory, payments
• claude-code — CLAUDE.md conventions, memory system
• agentic — agent loop patterns, tool use safety

Requirements

Node.js 18+

Modular builder (advanced)

If you prefer to compose rules with a script instead of npx, the original build-rules.ps1 (Windows) and build-rules.sh (Unix) are still available after cloning.

Contributing

See CONTRIBUTING.md. Adding a new module is just adding a .md file to modules/.

License

MIT