Now on npm — v0.2.2

Define once.
Spec everywhere.

The universal AI context infrastructure. Let AI generate and manage your project rules, while OpenSpec automatically syncs them to every AI coding tool in your stack.

Setup Guide See How It Works
$ /plugin marketplace add fernandomenuk/openspec
~/my-project
$ npx @menukfernando/openspec analyze
Analyzing codebase...
Created .openspec/modules/
# Codebase Analysis — OpenSpec
 
CLAUDE.md                        written
.cursorrules                    written
GEMINI.md                        written
.github/copilot-instructions.md written
.aiderrules                     written
AGENTS.md                        written
.windsurfrules                  written
 
Synced 7 targets in 12ms
Works with every AI coding tool
C Claude Code
Cursor
G Gemini
Copilot
A Aider
Codex
W Windsurf

Your AI tools are out of sync.

Every AI coding tool uses its own context file. Teams end up copy-pasting rules into 7+ files. When conventions change, updates drift — and different tools follow different rules.

  • × Copy-paste the same rules into 7 different files
  • × Update one file, forget the rest — rules drift silently
  • × Different AI tools generate inconsistent code
  • × No single source of truth for project conventions
CLAUDE.md
Claude Code
.cursorrules
Cursor
GEMINI.md
Gemini CLI
.aiderrules
Aider
copilot-instructions.md
GitHub Copilot
AGENTS.md
OpenAI Codex
.windsurfrules
Windsurf
+ more coming...
New tools daily

Zero manual work.

Let AI analyze your project and write the rules. OpenSpec compiles them into every format your tools need.

1

Add Plugin

Enable OpenSpec in your AI agent session.

# Inside Claude Code:
/plugin marketplace add fernandomenuk/openspec
/plugin install openspec@openspec
2

Run /openspec:configure

Claude analyzes your codebase, creates rule modules, and syncs everything automatically.

/openspec:configure
# AI does the work. You do nothing.
3

Zero Drift

Your AI agent now manages a single source of truth for every tool in your stack.

# One change syncs to:
CLAUDE.md, .cursorrules, GEMINI.md...

Integration for every tool.

Pick your primary tool and let OpenSpec handle the rest.

Recommended

Claude Code

The most powerful way to use OpenSpec. Claude manages your rules autonomously through the marketplace plugin.

# Add Marketplace /plugin marketplace add fernandomenuk/openspec # Install Plugin /plugin install openspec@openspec # Initialize & Sync /openspec:configure
Any Agent

IDE & CLI Agents

Using Cursor, Windsurf, or Aider? Simply prompt your agent to use the OpenSpec CLI autonomously.

# Tell your AI Agent: "Run npx @menukfernando/openspec analyze, use it to write rules to .openspec/modules/, then sync."
Infrastructure

Continuous Sync

Ensure your team is always aligned. Sync rules automatically on every commit or in your CI/CD pipeline.

# Install Git Hook npx @menukfernando/openspec hooks # Or run in CI npx @menukfernando/openspec sync

Built for real workflows.

Everything you need to keep your AI tools aligned with your team's conventions.

Modular Rules

Organize rules into focused Markdown modules — shared, frontend, backend, testing, or custom.

Smart Adapters

Each target gets intelligently adapted output. Claude prefers dense context, Cursor gets glob hints, Copilot gets nested headings.

/openspec:configure Slash Command

Run /openspec:configure in Claude Code and it analyzes your entire codebase, then generates project-specific modules automatically. No manual editing.

Watch Mode

Auto-sync on file changes. Edit a module, and all 7 targets update instantly in the background.

Git Hooks

Auto-sync before every commit with a pre-commit hook. No stale files, ever.

Diff Preview

See exactly what changes sync would make before writing anything with openspec diff.

One source. Seven outputs.

Every major AI coding tool, supported out of the box. More targets added regularly.

Claude Code
CLAUDE.md
Cursor
.cursorrules
Gemini
GEMINI.md
GitHub Copilot
.github/copilot-instructions.md
Aider
.aiderrules
Codex
AGENTS.md
Windsurf
.windsurfrules

Powerful commands.

A complete CLI toolkit for managing your AI context files.

openspec init
Scaffold .openspec/ with config and starter modules
openspec sync
Compile modules and generate all target files
openspec analyze
Analyze your codebase for AI-powered rule generation
openspec watch
Auto-sync on file changes — edit once, update everywhere
openspec status
Show all modules, targets, and current sync status
±
openspec diff
Preview what changes sync would make before writing
+
openspec add <name>
Scaffold a new rule module with priority and target options
🔗
openspec hooks
Install or remove git pre-commit hook for auto-sync
openspec install
Install the /openspec:configure Claude Code Plugin — AI analyzes your codebase and generates modules automatically

Stop copy-pasting
AI rules.

Get started in seconds. Define once, spec everywhere.