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