AI Global

# AI Global

[中文文档](README_CN.md)

Unified configuration manager for AI coding assistants. Edit one file, sync to all your AI tools.

## Installation

### curl

```bash
curl -fsSL https://raw.githubusercontent.com/nanxiaobei/ai-global/main/install.sh | bash
```

### npm

```bash
npm install -g ai-global
# or
pnpm add -g ai-global
# or
yarn global add ai-global
# or
bun add -g ai-global
```

## Usage

### First run

```bash
ai-global
```

This will:

1. Scan your system for installed AI tools
2. Backup original configs to `~/.ai-global/backups/`
3. Merge global/skills/agents/rules/commands/prompts from all tools
4. Create symlinks from each tool's config to shared directories

### Commands

| Command                      | Description                            |
| ---------------------------- | -------------------------------------- |
| `ai-global`                  | Scan, merge, update symlinks (default) |
| `ai-global status`           | Show symlink status                    |
| `ai-global list`             | List supported tools                   |
| `ai-global backups`          | List available backups                 |
| `ai-global unlink <tool>`    | Unlink a tool's original config        |
| `ai-global unlink all`       | Unlink all tools                       |
| `ai-global skill <source>`   | Add a skill (file or GitHub repo)      |
| `ai-global agent <source>`   | Add an agent                           |
| `ai-global rule <source>`    | Add a rule                             |
| `ai-global command <source>` | Add a command                          |
| `ai-global prompt <source>`  | Add a prompt                           |
| `ai-global upgrade`          | Upgrade to latest version              |
| `ai-global uninstall`        | Completely remove ai-global            |
| `ai-global version`          | Show version                           |
| `ai-global help`             | Show help                              |

### Add skill/agent/rule/command/prompt

```bash
ai-global skill user/repo
ai-global skill https://github.com/user/repo
```

## How it works

```
~/.ai-global/
├── global.md        <- Shared global (edit this)
├── skills/          <- Shared skills (merged from all tools)
├── agents/          <- Shared agents
├── rules/           <- Shared rules
├── commands/        <- Shared slash commands
├── prompts/         <- Shared prompt templates
└── backups/         <- Original configs (backup)

Each AI tool's config directory contains symlinks:

~/.claude/
├── CLAUDE.md -> ~/.ai-global/global.md        (symlink)
├── skills/   -> ~/.ai-global/skills/          (symlink)
└── commands/ -> ~/.ai-global/commands/        (symlink)

~/.cursor/
├── rules/global.md -> ~/.ai-global/global.md       (symlink)
├── skills/         -> ~/.ai-global/skills/         (symlink)
└── prompts/        -> ~/.ai-global/prompts/        (symlink)

... and more tools
```

## Merge behavior

When you run `ai-global`, it merges items from all tools by filename:

- Cursor has skills: `react/`, `typescript/`
- Claude has skills: `typescript/`, `python/`
- Result in `~/.ai-global/skills/`: `react/`, `typescript/`, `python/`

The first file found wins (dedup by filename).

## Supported Tools

| Tool              | Global | Skills | Agents | Rules | Commands | Prompts |
| ----------------- | :----: | :----: | :----: | :---: | :------: | :-----: |
| Claude Code       |   ✓    |   ✓    |        |       |    ✓     |         |
| Cursor            |   ✓    |   ✓    |        |       |          |    ✓    |
| GitHub Copilot    |   ✓    |        |        |       |          |         |
| Factory Droid     |   ✓    |        |        |       |          |         |
| Gemini CLI        |   ✓    |   ✓    |        |       |    ✓     |         |
| Windsurf          |   ✓    |   ✓    |   ✓    |   ✓   |          |         |
| Kiro              |   ✓    |        |   ✓    |       |          |         |
| Qodo              |   ✓    |        |   ✓    |       |          |         |
| Antigravity       |   ✓    |   ✓    |        |       |    ✓     |         |
| Continue          |   ✓    |        |        |   ✓   |          |    ✓    |
| Cline             |   ✓    |        |        |   ✓   |          |    ✓    |
| Roo Code          |   ✓    |        |        |   ✓   |          |         |
| Sourcegraph Cody  |   ✓    |        |        |       |    ✓     |         |
| CodeGPT           |   ✓    |        |        |       |          |    ✓    |
| GPT Engineer      |   ✓    |        |        |       |          |    ✓    |
| Smol Developer    |   ✓    |        |        |       |          |    ✓    |
| Amp               |   ✓    |        |        |       |          |         |
| Trae              |   ✓    |        |        |       |          |         |
| OpenCode          |   ✓    |        |        |       |          |         |
| OpenAI Codex      |   ✓    |        |        |       |          |         |
| Aider             |   ✓    |        |        |       |

... (truncated)