What is AIS?
AI Rules Sync (AIS) is a CLI tool for synchronizing, managing, and sharing AI agent rules across projects and teams.
The Problem
Modern AI coding assistants (Cursor, GitHub Copilot, Claude Code, etc.) use project-level configuration files to customize their behavior. Teams often:
- Copy-paste rule files between projects
- Lose sync when rules are updated
- Lack consistency across team members and projects
- Can't share rules easily between teams
The Solution
AIS manages your rules in Git repositories and syncs them to projects via symbolic links. This means:
- Single source of truth — edit once, update everywhere
- Version controlled — track changes with Git
- Team sharing — share via Git repositories
- Multi-tool support — one workflow for Cursor, Copilot, Claude, and more
Supported Tools
AIS supports a wide range of AI coding tools:
| Tool | Type | Mode | Default Source Directory | File Suffixes | Documentation |
|---|---|---|---|---|---|
| Cursor | Rules | hybrid | .cursor/rules/ | .mdc, .md | Docs |
| Cursor | Commands | file | .cursor/commands/ | .md | Docs |
| Cursor | Skills | directory | .cursor/skills/ | - | Docs |
| Cursor | Subagents | directory | .cursor/agents/ | - | Docs |
| GitHub Copilot | Instructions | file | .github/instructions/ | .instructions.md, .md | Docs |
| GitHub Copilot | Prompts | file | .github/prompts/ | .prompt.md, .md | Docs |
| GitHub Copilot | Skills | directory | .github/skills/ | - | Docs |
| GitHub Copilot | Agents | file | .github/agents/ | .agent.md, .md | Docs |
| Claude Code | Rules | file | .claude/rules/ | .md | Docs |
| Claude Code | Skills | directory | .claude/skills/ | - | Docs |
| Claude Code | Subagents | directory | .claude/agents/ | - | Docs |
| Claude Code | CLAUDE.md | file | .claude/ | .md | Docs |
| Trae | Rules | file | .trae/rules/ | .md | Docs |
| Trae | Skills | directory | .trae/skills/ | - | Docs |
| OpenCode | Commands | file | .opencode/commands/ | .md | Docs |
| OpenCode | Skills | directory | .opencode/skills/ | - | Docs |
| OpenCode | Agents | file | .opencode/agents/ | .md | Docs |
| OpenCode | Tools | file | .opencode/tools/ | .ts, .js | Docs |
| Codex | Rules | file | .codex/rules/ | .rules | Docs |
| Codex | Skills | directory | .agents/skills/ | - | Docs |
| Codex | AGENTS.md | file | .codex/ | .md | Docs |
| Gemini CLI | Commands | file | .gemini/commands/ | .toml | Docs |
| Gemini CLI | Skills | directory | .gemini/skills/ | - | Docs |
| Gemini CLI | Agents | file | .gemini/agents/ | .md | Docs |
| Gemini CLI | GEMINI.md | file | .gemini/ | .md | Website |
| Warp | Rules | file | . (root) | .md | Docs |
| Warp | Skills | directory | .agents/skills/ | - | Docs |
| Windsurf | Rules | file | .windsurf/rules/ | .md | Docs |
| Windsurf | Skills | directory | .windsurf/skills/ | - | Docs |
| Cline | Rules | file | .clinerules/ | .md, .txt | Docs |
| Cline | Skills | directory | .cline/skills/ | - | Docs |
| Universal | AGENTS.md | file | . (root) | .md | Standard |
Modes
- directory — Links entire directories (skills, agents)
- file — Links individual files with automatic suffix resolution
- hybrid — Links both files and directories (e.g., Cursor rules)
How It Works
AIS manages rules at two scopes via symbolic links:
- Project-Level Sync — Sync rules into a project directory, tracked in
ai-rules-sync.jsonand shared with your team - User Global-Level Sync — Sync personal AI configs into
$HOME, tracked in~/.config/ai-rules-sync/user.json