flins 0.2.5 → 0.3.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 (3) hide show
  1. package/README.md +74 -5
  2. package/dist/index.js +89 -156
  3. package/package.json +6 -8
package/README.md CHANGED
@@ -2,16 +2,22 @@
2
2
 
3
3
  Universal skill and command manager for AI coding agents.
4
4
 
5
- Install, manage, and update skills and commands across 16+ AI development tools from a single unified interface.
5
+ Install, manage, and update skills and commands across 42 supported agent integrations from one CLI.
6
6
 
7
7
  ## Installation
8
8
 
9
9
  ```bash
10
- # Using npx (recommended)
10
+ # Local install with bunx (default)
11
+ bunx --bun flins@latest add <source>
12
+
13
+ # Local install with npx (default)
11
14
  npx flins@latest add <source>
12
15
 
13
- # Install globally
14
- npm install -g flins
16
+ # Explicit global install
17
+ bunx --bun flins@latest add <source> --global
18
+
19
+ # Install globally with Bun
20
+ bun add -g flins
15
21
  flins add <source>
16
22
  ```
17
23
 
@@ -19,21 +25,39 @@ flins add <source>
19
25
 
20
26
  ```bash
21
27
  # Install from flins directory
28
+ bunx --bun flins@latest add better-auth
29
+
30
+ # Install from flins directory with npx
22
31
  npx flins@latest add better-auth
23
32
 
24
33
  # Install from GitHub
34
+ bunx --bun flins@latest add expo/skills
35
+
36
+ # Install from GitHub with npx
25
37
  npx flins@latest add expo/skills
26
38
 
27
39
  # Install from any git repo
40
+ bunx --bun flins@latest add https://gitlab.com/org/repo
41
+
42
+ # Install from any git repo with npx
28
43
  npx flins@latest add https://gitlab.com/org/repo
29
44
 
30
45
  # Install from well-known endpoint (RFC)
46
+ bunx --bun flins@latest add developer.cloudflare.com
47
+
48
+ # Install from well-known endpoint (RFC) with npx
31
49
  npx flins@latest add developer.cloudflare.com
32
50
 
33
51
  # Install globally
52
+ bunx --bun flins@latest add expo --global
53
+
54
+ # Install globally with npx
34
55
  npx flins@latest add expo --global
35
56
 
36
57
  # Browse available skills
58
+ bunx --bun flins@latest search
59
+
60
+ # Browse available skills with npx
37
61
  npx flins@latest search
38
62
  ```
39
63
 
@@ -66,12 +90,57 @@ Works with any RFC-compatible domain.
66
90
  | `flins search` | Interactive skill browser |
67
91
  | `flins clean` | Remove orphaned state entries |
68
92
 
93
+ ## Supported Agents
94
+
95
+ flins supports these canonical `--agent` values:
96
+
97
+ Local installs default to `universal`, which writes to `.agents/skills` and is picked up by Amp, Cline, Codex, Cursor, Gemini CLI, GitHub Copilot, Kimi Code CLI, OpenCode, Replit, and Universal. In the interactive local installer, that shared folder appears once as `universal` instead of repeating those agents as separate checkboxes.
98
+
99
+ | Project folder | Agents | `--agent` values |
100
+ | --------------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
101
+ | `.agents/skills` | Amp, Cline, Codex, Cursor, Gemini CLI, GitHub Copilot, Kimi Code CLI, OpenCode, Replit, Universal | `amp`, `cline`, `codex`, `cursor`, `gemini-cli`, `github-copilot`, `kimi-cli`, `opencode`, `replit`, `universal` |
102
+ | `.agent/skills` | Antigravity | `antigravity` |
103
+ | `.augment/skills` | Augment | `augment` |
104
+ | `.claude/skills` | Claude Code | `claude-code` |
105
+ | `skills/` | OpenClaw | `openclaw` |
106
+ | `.codebuddy/skills` | CodeBuddy | `codebuddy` |
107
+ | `.commandcode/skills` | Command Code | `command-code` |
108
+ | `.continue/skills` | Continue | `continue` |
109
+ | `.cortex/skills` | Cortex Code | `cortex` |
110
+ | `.crush/skills` | Crush | `crush` |
111
+ | `.factory/skills` | Droid | `droid` |
112
+ | `.goose/skills` | Goose | `goose` |
113
+ | `.junie/skills` | Junie | `junie` |
114
+ | `.iflow/skills` | iFlow CLI | `iflow-cli` |
115
+ | `.kilocode/skills` | Kilo Code | `kilo` |
116
+ | `.kiro/skills` | Kiro CLI | `kiro-cli` |
117
+ | `.kode/skills` | Kode | `kode` |
118
+ | `.skills` | Letta | `letta` |
119
+ | `.mcpjam/skills` | MCPJam | `mcpjam` |
120
+ | `.vibe/skills` | Mistral Vibe | `mistral-vibe` |
121
+ | `.mux/skills` | Mux | `mux` |
122
+ | `.openhands/skills` | OpenHands | `openhands` |
123
+ | `.pi/skills` | Pi | `pi` |
124
+ | `.qoder/skills` | Qoder | `qoder` |
125
+ | `.qwen/skills` | Qwen Code | `qwen-code` |
126
+ | `.roo/skills` | Roo Code | `roo` |
127
+ | `.trae/skills` | Trae, Trae CN | `trae`, `trae-cn` |
128
+ | `.windsurf/skills` | Windsurf | `windsurf` |
129
+ | `.zencoder/skills` | Zencoder | `zencoder` |
130
+ | `.neovate/skills` | Neovate | `neovate` |
131
+ | `.pochi/skills` | Pochi | `pochi` |
132
+ | `.adal/skills` | AdaL | `adal` |
133
+
134
+ See the Supported Agents table above when you need canonical ids and project folders.
135
+
69
136
  ## Symlink-First Architecture
70
137
 
71
138
  By default, flins stores source files in `.agents/` and creates symlinks to each agent's directory. This means one source, multiple agents — no duplicate files.
72
139
 
73
140
  Use `--no-symlink` to copy files directly instead.
74
141
 
142
+ Command installation exists, but it is still experimental and currently limited to `claude-code`, `opencode`, and `droid`.
143
+
75
144
  ## Documentation
76
145
 
77
- For complete documentation, see the [main README](https://github.com/flinstech/flins/?tab=readme-ov-file#flins).
146
+ For complete documentation, see the [main README](https://github.com/powroom/flins/?tab=readme-ov-file#flins).