DevSync¶
AI-powered dev config distribution across AI coding assistants.
DevSync extracts coding practices from any project and installs them into 23+ AI coding assistants with intelligent adaptation. Two commands replace hours of manual configuration copying.
AI-Powered Extraction¶
Extract coding standards, style guides, and MCP configs from any project into shareable practice declarations.
Intelligent Installation¶
AI adapts incoming practices to your existing setup -- merging, not overwriting.
Configuration Packages¶
Bundle practices, MCP servers, hooks, commands, and resources into installable packages.
23+ IDE Integrations¶
Claude Code, Cursor, Windsurf, GitHub Copilot, Codex CLI, Cline, Kiro, Roo Code, Anteroom, and more.
Quick Start¶
# Install DevSync
$ pip install devsync
# Configure your LLM provider (one-time)
$ devsync setup
# Check which AI tools are detected
$ devsync tools
# Extract practices from a project with existing rules
$ cd ~/my-team-project
$ devsync extract --output ./team-standards --name team-standards
# Install those practices into another project
$ cd ~/new-project
$ devsync install ~/my-team-project/team-standards
See the full quickstart guide for a 5-minute walkthrough.
Why DevSync?¶
For teams:
- Consistency -- everyone uses the same AI instructions and tool configs
- Onboarding -- new developers get configured in minutes, not hours
- Compliance -- enforce security policies and review checklists automatically
- No secrets in Git -- credentials stay local, configurations are shared
For individuals:
- Portable -- same setup across all your machines
- Composable -- layer company, team, and personal configs
- Works without AI -- graceful degradation to file-copy mode when no API key
- Safe -- conflict resolution, checksums, installation tracking
Supported IDEs¶
Multi-file IDEs¶
| Tool | Instruction Path | Extension |
|---|---|---|
| Claude Code | .claude/rules/ | .md |
| Cursor | .cursor/rules/ | .mdc |
| Windsurf | .windsurf/rules/ | .md |
| GitHub Copilot | .github/instructions/ | .instructions.md |
| Roo Code | .roo/rules/ | .md |
| Cline | .clinerules/ | .md |
| Kiro | .kiro/steering/ | .md |
| + 8 more | Full list |
Single-file IDEs¶
| Tool | Instruction File |
|---|---|
| Codex CLI | AGENTS.md |
| Aider | CONVENTIONS.md |
| Gemini CLI | GEMINI.md |
| + 4 more | Full list |
How It Works¶
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Source Project │────>│ Package with │────>│ Target Project │
│ (team configs) │ │ Practices │ │ IDE Config │
│ │ │ │ │ .cursor/rules/ │
└─────────────────┘ └──────────────────┘ │ .claude/rules/ │
devsync extract devsync install │ .windsurf/... │
└─────────────────┘
- Extract practices from a project's existing rules, MCP configs, and commands
- Share the resulting package via Git or local directory
- Install into any project -- AI adapts practices to the recipient's existing setup
- Track installations in
.devsync/packages.jsonfor management
Documentation¶
| Section | What you'll find |
|---|---|
| Getting Started | Installation, quickstart, core concepts |
| CLI Reference | All 6 commands with examples |
| IDE Integrations | Setup guides for each AI tool |
| Packages | Creating and installing config packages |
| Tutorials | Step-by-step walkthroughs |
| Advanced | Config types, conflict resolution, contributing |
| Reference | Full CLI reference, YAML schemas |