agdex 0.4.1 → 0.5.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 (46) hide show
  1. package/README.md +42 -5
  2. package/dist/cli/configurable-select.d.ts +15 -0
  3. package/dist/cli/configurable-select.d.ts.map +1 -0
  4. package/dist/cli/index.js +444 -106
  5. package/dist/{index-9gy9s47s.js → index-974mhezm.js} +919 -61
  6. package/dist/index-g5x6jpyb.js +2304 -0
  7. package/dist/{index-pkx4s2ef.js → index-nn4xptha.js} +42 -15
  8. package/dist/index-pfdh6eyh.js +2241 -0
  9. package/dist/{index-4shp3mqh.js → index-vf9nfyjb.js} +369 -60
  10. package/dist/{index-zrmn6fd2.js → index-wsqyam11.js} +301 -68
  11. package/dist/index.d.ts +1 -1
  12. package/dist/index.d.ts.map +1 -1
  13. package/dist/index.js +3 -1
  14. package/dist/lib/agents-md.d.ts +5 -0
  15. package/dist/lib/agents-md.d.ts.map +1 -1
  16. package/dist/lib/providers/cuda-feedstock.d.ts +6 -0
  17. package/dist/lib/providers/cuda-feedstock.d.ts.map +1 -0
  18. package/dist/lib/providers/generic.d.ts.map +1 -1
  19. package/dist/lib/providers/index.d.ts +3 -0
  20. package/dist/lib/providers/index.d.ts.map +1 -1
  21. package/dist/lib/providers/shadcn-svelte.d.ts +3 -0
  22. package/dist/lib/providers/shadcn-svelte.d.ts.map +1 -0
  23. package/dist/lib/providers/sveltekit.d.ts +3 -0
  24. package/dist/lib/providers/sveltekit.d.ts.map +1 -0
  25. package/dist/lib/skills.d.ts +13 -2
  26. package/dist/lib/skills.d.ts.map +1 -1
  27. package/dist/lib/types.d.ts +18 -3
  28. package/dist/lib/types.d.ts.map +1 -1
  29. package/package.json +1 -1
  30. package/dist/index-57bfejpe.js +0 -1357
  31. package/dist/index-5h59833k.js +0 -1270
  32. package/dist/index-6dj5che8.js +0 -859
  33. package/dist/index-6e18afd7.js +0 -1229
  34. package/dist/index-7adbtddf.js +0 -1123
  35. package/dist/index-cfpc7eqp.js +0 -1265
  36. package/dist/index-db6kreh4.js +0 -1188
  37. package/dist/index-exr11by8.js +0 -708
  38. package/dist/index-fxmpwsct.js +0 -779
  39. package/dist/index-gtzz9131.js +0 -708
  40. package/dist/index-hr5jh9yq.js +0 -712
  41. package/dist/index-k299aha0.js +0 -1229
  42. package/dist/index-ntpyfcve.js +0 -1154
  43. package/dist/index-p0xjkwcp.js +0 -1283
  44. package/dist/index-pry8ssn1.js +0 -636
  45. package/dist/index-wgnqr8g3.js +0 -882
  46. package/dist/index-y6zqcrbh.js +0 -788
package/README.md CHANGED
@@ -114,7 +114,8 @@ npx agdex --provider nextjs --description "Project uses App Router only"
114
114
  --fw-version <version> Framework version (auto-detected if not provided)
115
115
  -o, --output <file> Target file (default: from config or CLAUDE.md)
116
116
  -d, --description <text> Additional description to include in the index
117
- -g, --global Store docs in global cache (~/.cache/agdex/)
117
+ -g, --global Use global cache ~/.cache/agdex/ (default)
118
+ -l, --local Use local .agdex/ instead
118
119
  ```
119
120
 
120
121
  ### Custom GitHub Repository
@@ -133,25 +134,35 @@ npx agdex local ./docs --name "My Framework" --output AGENTS.md
133
134
 
134
135
  ### Skills Indexing
135
136
 
136
- Index Claude Code skills from your `.claude` directories and enabled plugins:
137
+ Index Claude Code skills from your `.claude` directories, enabled plugins, and remote [skills.sh](https://skills.sh) repositories:
137
138
 
138
139
  ```bash
139
140
  # Index skills (auto-detects from all sources)
140
141
  npx agdex skills embed
141
142
 
143
+ # Index from a skills.sh-compatible GitHub repo
144
+ npx agdex skills embed --repo owner/repo
145
+
142
146
  # List discovered skills
143
147
  npx agdex skills list
144
148
 
145
149
  # Index from a specific local path
146
150
  npx agdex skills local ./my-skills --name "My Skills"
151
+
152
+ # Search skills.sh for community skills
153
+ npx agdex skills find "debugging"
154
+
155
+ # Search with a result limit
156
+ npx agdex skills find "frontend" --limit 10
147
157
  ```
148
158
 
149
159
  **Auto-detection sources:**
150
160
  - **Enabled plugins** - Reads `~/.claude/settings.json` and `.claude/settings.json` to find enabled plugins, then indexes their skills from the plugin cache
151
161
  - **User skills** - `~/.claude/skills` (shared across projects)
152
162
  - **Project skills** - `.claude/skills` (project-specific)
163
+ - **Remote repos** - Any GitHub repo with skills in standard locations (`skills/`, `.claude/skills/`, `.agents/skills/`)
153
164
 
154
- **Options:**
165
+ **Options for `skills embed`:**
155
166
  ```bash
156
167
  --plugins Include enabled plugins from settings.json (default: true)
157
168
  --no-plugins Exclude enabled plugins
@@ -160,9 +171,18 @@ npx agdex skills local ./my-skills --name "My Skills"
160
171
  --project Include .claude/skills (default: true)
161
172
  --no-project Exclude .claude/skills
162
173
  --plugin <path> Additional plugin repo paths (with plugins/ structure)
174
+ --repo <owner/repo> Fetch and index from a skills.sh-compatible GitHub repo
163
175
  -o, --output Target file (default: AGENTS.md)
164
176
  ```
165
177
 
178
+ **Options for `skills find`:**
179
+ ```bash
180
+ -l, --limit <n> Max results (default: 20)
181
+ -o, --output Target file for embedding
182
+ ```
183
+
184
+ Running `skills find` without a query argument launches interactive mode, where you can search and immediately embed a selected result.
185
+
166
186
  Skills are discovered by looking for `SKILL.md` files with YAML frontmatter:
167
187
  ```yaml
168
188
  ---
@@ -173,6 +193,22 @@ description: What this skill does
173
193
 
174
194
  The index includes skill names, descriptions, and all sibling files (recursively).
175
195
 
196
+ ### Removing Indexes
197
+
198
+ Remove embedded indexes interactively or by flag:
199
+
200
+ ```bash
201
+ # Interactive mode - select which indexes to remove
202
+ npx agdex remove
203
+
204
+ # Remove a specific provider's docs index
205
+ npx agdex remove --provider nextjs
206
+
207
+ # Remove only docs or skills indexes
208
+ npx agdex remove --docs
209
+ npx agdex remove --skills
210
+ ```
211
+
176
212
  ### List Available Providers
177
213
 
178
214
  ```bash
@@ -262,8 +298,11 @@ This format:
262
298
  | rattler-build | ✓ | prefix-dev/rattler-build |
263
299
  | Tauri | ✓ | tauri-apps/tauri-docs |
264
300
  | conda-forge | ✓ | conda-forge/conda-forge.github.io |
301
+ | CUDA Feedstock | ✓ | conda-forge/cuda-feedstock |
265
302
  | Bun | ✓ | oven-sh/bun |
266
303
  | Svelte | ✓ | sveltejs/svelte |
304
+ | SvelteKit | ✓ | sveltejs/kit |
305
+ | shadcn-svelte | ✓ | huntabyte/shadcn-svelte |
267
306
  | Tailwind CSS | ✓ | tailwindlabs/tailwindcss.com |
268
307
  | Ruff | ✓ | astral-sh/ruff |
269
308
  | ty | ✓ | astral-sh/ty |
@@ -275,8 +314,6 @@ This format:
275
314
  | Obsidian Excalidraw | ✓ | zsviczian/obsidian-excalidraw-plugin |
276
315
  | FFmpeg | ✓ | FFmpeg/FFmpeg |
277
316
  | Manim | ✓ | ManimCommunity/manim |
278
- | Vue | ○ | Coming soon |
279
- | Astro | ○ | Coming soon |
280
317
 
281
318
  ## How It Works
282
319
 
@@ -0,0 +1,15 @@
1
+ export interface ConfigurableChoice {
2
+ title: string;
3
+ value: string;
4
+ defaultVersion: string;
5
+ }
6
+ export interface ConfigurableResult {
7
+ value: string;
8
+ version: string;
9
+ description: string;
10
+ }
11
+ export declare function configurableMultiselect(options: {
12
+ message: string;
13
+ choices: ConfigurableChoice[];
14
+ }): Promise<ConfigurableResult[] | null>;
15
+ //# sourceMappingURL=configurable-select.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"configurable-select.d.ts","sourceRoot":"","sources":["../../src/cli/configurable-select.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE;IACrD,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAC9B,GAAG,OAAO,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC,CAyKvC"}