ai-global 1.15.0 → 2.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +102 -61
- package/ai-global +691 -889
- package/package.json +18 -15
- package/scripts/postinstall.js +15 -2
package/README.md
CHANGED
|
@@ -1,11 +1,19 @@
|
|
|
1
1
|
# AI Global
|
|
2
2
|
|
|
3
|
-
[简体中文](README_CN.md)
|
|
3
|
+
English · [简体中文](README_CN.md) · [繁體中文](README_TW.md) · [日本語](README_JP.md)· [한국어](README_KR.md)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
**Unified Configuration Manager for AI Coding Tools.**
|
|
8
|
+
|
|
9
|
+
Edit one file, sync to all your AI tools.
|
|
10
|
+
|
|
11
|
+
Works both **System Mode** & **Project Mode**.
|
|
6
12
|
|
|
7
13
|
## Installation
|
|
8
14
|
|
|
15
|
+
Install with `curl` or `npm`:
|
|
16
|
+
|
|
9
17
|
### curl
|
|
10
18
|
|
|
11
19
|
```bash
|
|
@@ -26,6 +34,13 @@ bun add -g ai-global
|
|
|
26
34
|
|
|
27
35
|
## Usage
|
|
28
36
|
|
|
37
|
+
### Automatic Mode Detection
|
|
38
|
+
|
|
39
|
+
AI Global automatically detects your context:
|
|
40
|
+
|
|
41
|
+
- **System Mode**: When run from `~` directory, unified configs for system-wide
|
|
42
|
+
- **Project Mode**: When run from any project directory (not `~`), unified configs for project-specific
|
|
43
|
+
|
|
29
44
|
### First run
|
|
30
45
|
|
|
31
46
|
```bash
|
|
@@ -34,46 +49,50 @@ ai-global
|
|
|
34
49
|
|
|
35
50
|
This will:
|
|
36
51
|
|
|
37
|
-
1.
|
|
38
|
-
2.
|
|
39
|
-
3.
|
|
40
|
-
4.
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
|
46
|
-
|
|
|
47
|
-
| `ai-global
|
|
48
|
-
| `ai-global
|
|
49
|
-
| `ai-global
|
|
50
|
-
| `ai-global
|
|
51
|
-
| `ai-global unlink
|
|
52
|
-
| `ai-global
|
|
53
|
-
| `ai-global
|
|
54
|
-
| `ai-global
|
|
55
|
-
| `ai-global
|
|
56
|
-
| `ai-global
|
|
52
|
+
1. Detect current directory (system or project)
|
|
53
|
+
2. Scan for installed AI tools
|
|
54
|
+
3. Backup original configs to `.ai-global/backups/`
|
|
55
|
+
4. Merge AGENTS.md/skills/rules/commands from detected tools
|
|
56
|
+
5. Create symlinks from each tool's config to shared directories
|
|
57
|
+
|
|
58
|
+
## Commands
|
|
59
|
+
|
|
60
|
+
| Command | Description | Context-aware |
|
|
61
|
+
| --------------------------- | -------------------------------------- | ------------- |
|
|
62
|
+
| `ai-global` | Scan, merge, update symlinks (default) | Yes |
|
|
63
|
+
| `ai-global status` | Show symlinks status | Yes |
|
|
64
|
+
| `ai-global list` | List all supported AI tools | Yes |
|
|
65
|
+
| `ai-global backups` | List available backups | Yes |
|
|
66
|
+
| `ai-global unlink <key>` | Restore a tool's original config | Yes |
|
|
67
|
+
| `ai-global unlink all` | Restore all tools | Yes |
|
|
68
|
+
| `ai-global add <user/repo>` | Add skills from GitHub repository | Yes |
|
|
69
|
+
| `ai-global upgrade` | Upgrade to latest version | |
|
|
70
|
+
| `ai-global uninstall` | Completely remove ai-global | |
|
|
71
|
+
| `ai-global version` | Show version | |
|
|
72
|
+
| `ai-global help` | Show help | |
|
|
73
|
+
|
|
74
|
+
**Context-aware**: Command behavior depends on current directory (system vs project)
|
|
57
75
|
|
|
58
76
|
### Add skills
|
|
59
77
|
|
|
60
78
|
```bash
|
|
61
|
-
ai-global
|
|
62
|
-
ai-global
|
|
79
|
+
ai-global add user/repo
|
|
80
|
+
ai-global add https://github.com/user/repo
|
|
63
81
|
```
|
|
64
82
|
|
|
83
|
+
Skills will be downloaded and added to your `.ai-global/skills/` directory.
|
|
84
|
+
|
|
65
85
|
## How it works
|
|
66
86
|
|
|
87
|
+
### System Mode Structure
|
|
88
|
+
|
|
67
89
|
```
|
|
68
90
|
~/.ai-global/
|
|
69
91
|
├── AGENTS.md <- Shared AGENTS.md (edit this)
|
|
70
92
|
├── skills/ <- Shared skills (merged from all tools)
|
|
71
|
-
├── agents/ <- Shared agents
|
|
72
93
|
├── rules/ <- Shared rules
|
|
73
94
|
├── commands/ <- Shared slash commands
|
|
74
|
-
└── backups/ <- Original configs (
|
|
75
|
-
|
|
76
|
-
Each AI tool's config directory contains symlinks:
|
|
95
|
+
└── backups/ <- Original configs (backups)
|
|
77
96
|
|
|
78
97
|
~/.claude/
|
|
79
98
|
├── CLAUDE.md -> ~/.ai-global/AGENTS.md (symlink)
|
|
@@ -81,52 +100,74 @@ Each AI tool's config directory contains symlinks:
|
|
|
81
100
|
└── commands/ -> ~/.ai-global/commands/ (symlink)
|
|
82
101
|
|
|
83
102
|
~/.cursor/
|
|
84
|
-
├──
|
|
85
|
-
└── skills/
|
|
103
|
+
├── AGENTS.md -> ~/.ai-global/AGENTS.md (symlink)
|
|
104
|
+
└── skills/ -> ~/.ai-global/skills/ (symlink)
|
|
86
105
|
|
|
87
106
|
... and more tools
|
|
88
107
|
```
|
|
89
108
|
|
|
90
|
-
|
|
109
|
+
### Project Mode Structure
|
|
110
|
+
|
|
111
|
+
```
|
|
112
|
+
my-project/
|
|
113
|
+
├── .ai-global/ <- Project-specific configs
|
|
114
|
+
│ ├── AGENTS.md <- Project AGENTS.md
|
|
115
|
+
│ ├── skills/ <- Project skills
|
|
116
|
+
│ ├── rules/ <- Project rules
|
|
117
|
+
│ ├── commands/ <- Project commands
|
|
118
|
+
│ └── backups/ <- Project backups
|
|
119
|
+
└── .cursor/ <- AI tool config
|
|
120
|
+
├── AGENTS.md -> ../.ai-global/AGENTS.md (symlink)
|
|
121
|
+
└── skills/ -> ../.ai-global/skills/ (symlink)
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### Mode Behavior
|
|
125
|
+
|
|
126
|
+
- **System Mode**: Manages AI configs across your entire system
|
|
127
|
+
- **Project Mode**: Manages AI configs for a specific project only
|
|
128
|
+
- **Automatic Detection**: No commands needed to switch between modes
|
|
129
|
+
- **Context-Aware**: Commands will show which context they're operating in
|
|
130
|
+
|
|
131
|
+
### Merge behavior
|
|
91
132
|
|
|
92
133
|
When you run `ai-global`, it merges items from all tools by filename:
|
|
93
134
|
|
|
94
135
|
- Cursor has skills: `react/`, `typescript/`
|
|
95
136
|
- Claude has skills: `typescript/`, `python/`
|
|
96
|
-
- Result in
|
|
137
|
+
- Result in `.ai-global/skills/`: `react/`, `typescript/`, `python/`
|
|
97
138
|
|
|
98
|
-
|
|
139
|
+
**Last file wins** (later tools overwrite earlier tools with same filename).
|
|
99
140
|
|
|
100
141
|
## Supported Tools
|
|
101
142
|
|
|
102
|
-
| Tool | Key |
|
|
103
|
-
| -------------- | ------------- |
|
|
104
|
-
| Claude Code | `claude` |
|
|
105
|
-
| OpenAI Codex | `codex` |
|
|
106
|
-
| Cursor | `cursor` |
|
|
107
|
-
| Factory Droid | `droid` |
|
|
108
|
-
| Amp | `amp` |
|
|
109
|
-
| Antigravity | `antigravity` |
|
|
110
|
-
| Gemini CLI | `gemini` |
|
|
111
|
-
| Kiro CLI | `kiro` |
|
|
112
|
-
| OpenCode | `opencode` |
|
|
113
|
-
| Qoder | `qoder` |
|
|
114
|
-
| Qodo | `qodo` |
|
|
115
|
-
| GitHub Copilot | `copilot` |
|
|
116
|
-
| Continue | `continue` |
|
|
117
|
-
| Windsurf | `windsurf` |
|
|
118
|
-
| Roo Code | `roo` |
|
|
119
|
-
| Cline | `cline` |
|
|
120
|
-
| Blackbox AI | `blackbox` |
|
|
121
|
-
| Goose AI | `goose` |
|
|
122
|
-
| Augment | `augment` |
|
|
123
|
-
| Clawdbot Code | `clawdbot` |
|
|
124
|
-
| Command Code | `commandcode` |
|
|
125
|
-
| Kilo Code | `kilocode` |
|
|
126
|
-
| Neovate | `neovate` |
|
|
127
|
-
| OpenHands | `openhands` |
|
|
128
|
-
| TRAE | `trae` |
|
|
129
|
-
| Zencoder | `zencoder` |
|
|
143
|
+
| Tool | Key | AGENTS.md | Rules | Commands | Skills |
|
|
144
|
+
| -------------- | ------------- | :-------: | :---: | :------: | :----: |
|
|
145
|
+
| Claude Code | `claude` | ✓ | | ✓ | ✓ |
|
|
146
|
+
| OpenAI Codex | `codex` | ✓ | ✓ | | ✓ |
|
|
147
|
+
| Cursor | `cursor` | ✓ | ✓ | ✓ | ✓ |
|
|
148
|
+
| Factory Droid | `droid` | ✓ | ✓ | ✓ | ✓ |
|
|
149
|
+
| Amp | `amp` | ✓ | ✓ | ✓ | ✓ |
|
|
150
|
+
| Antigravity | `antigravity` | ✓ | | | ✓ |
|
|
151
|
+
| Gemini CLI | `gemini` | ✓ | | | ✓ |
|
|
152
|
+
| Kiro CLI | `kiro` | ✓ | ✓ | | ✓ |
|
|
153
|
+
| OpenCode | `opencode` | ✓ | | ✓ | ✓ |
|
|
154
|
+
| Qoder | `qoder` | ✓ | ✓ | ✓ | ✓ |
|
|
155
|
+
| Qodo | `qodo` | ✓ | | | |
|
|
156
|
+
| GitHub Copilot | `copilot` | ✓ | | | ✓ |
|
|
157
|
+
| Continue | `continue` | ✓ | ✓ | | |
|
|
158
|
+
| Windsurf | `windsurf` | ✓ | ✓ | | ✓ |
|
|
159
|
+
| Roo Code | `roo` | ✓ | ✓ | ✓ | ✓ |
|
|
160
|
+
| Cline | `cline` | ✓ | ✓ | | ✓ |
|
|
161
|
+
| Blackbox AI | `blackbox` | | | | ✓ |
|
|
162
|
+
| Goose AI | `goose` | ✓ | | | ✓ |
|
|
163
|
+
| Augment | `augment` | ✓ | ✓ | ✓ | |
|
|
164
|
+
| Clawdbot Code | `clawdbot` | ✓ | | | ✓ |
|
|
165
|
+
| Command Code | `commandcode` | ✓ | | ✓ | ✓ |
|
|
166
|
+
| Kilo Code | `kilocode` | ✓ | ✓ | ✓ | ✓ |
|
|
167
|
+
| Neovate | `neovate` | ✓ | | ✓ | ✓ |
|
|
168
|
+
| OpenHands | `openhands` | ✓ | | | ✓ |
|
|
169
|
+
| TRAE | `trae` | ✓ | ✓ | | ✓ |
|
|
170
|
+
| Zencoder | `zencoder` | ✓ | ✓ | | ✓ |
|
|
130
171
|
|
|
131
172
|
## Uninstall
|
|
132
173
|
|