claude-code-autoconfig 1.0.137 → 1.0.138

package/.claude/docs/autoconfig.docs.html

@@ -1263,7 +1263,7 @@
                 title: '.claude/ Directory',
                 desc: 'Commands, rules, settings, and these docs. Keeps configuration organized as your project grows.'
             },
-                                                            'rules': {
+                                                                        'rules': {
                 title: 'rules/',
                 desc: 'Path-scoped context that loads when Claude works on matching files.'
             },
@@ -1305,7 +1305,7 @@
             },
             'gls': {
                 title: 'gls.md',
-                desc: 'gls.md in commands/',
+                desc: 'gls.md in commands/\n\n- `/gls` - Get and display the most recent screenshot\n- `/gls-2` - Get and display the 2 most recent screenshots\n- `/gls-3` - Get and display the 3 most recent screenshots\n- `/gls-N` - Get and display the N most recent screenshots\n- `/gls /path/to/dir` - Use a specific directory and save it',
                 trigger: '/gls'
             },
             'publish': {
@@ -1315,7 +1315,7 @@
             },
             'recover-context': {
                 title: 'recover-context.md',
-                desc: 'Recovers conversation context from the session transcript after compaction.\n\nUsage: /recover-context -60 (last 60 min), -30 (last 30 min), -120 (last 2 hrs).\nAdd --show to open the transcript in your editor.\nThe number works with or without the leading dash.',
+                desc: 'Recovers conversation context from the session transcript after compaction.\n\n- `/recover-context -60` — last 60 minutes of conversation\n- `/recover-context 60` — same thing (dash is optional)\n- `/recover-context -30` — last 30 minutes\n- `/recover-context -120` — last 2 hours\n- `/recover-context -60 --show` — same as above, but also opens the filtered transcript in default editor',
                 trigger: '/recover-context'
             },
             'show-docs': {
@@ -1569,7 +1569,7 @@ CRITICAL: A plausible-looking cause from code reading is NOT confirmed evidence.
 
 > Run \`/autoconfig\` to populate this based on your project.`
             },
-                                                            'autoconfig-update': {
+                                                                        'autoconfig-update': {
                 filename: 'autoconfig-update.md',
                 content: `<!-- @applied
 -->
@@ -1760,11 +1760,12 @@ Run tests, bump the patch version, commit, push, and publish to npm.
 
 Usage:
 - \`/recover-context -60\` — last 60 minutes of conversation
+- \`/recover-context 60\` — same thing (dash is optional)
 - \`/recover-context -30\` — last 30 minutes
 - \`/recover-context -120\` — last 2 hours
 - \`/recover-context -60 --show\` — same as above, but also opens the filtered transcript in default editor
 
-The negative number means "go back N minutes from now." The minutes argument is **required**.
+The number means "go back N minutes from now." The leading dash is optional. The minutes argument is **required**.
 
 ## Step 1: Parse the arguments
 
@@ -2084,6 +2085,8 @@ Claude reads this file but must never write to it. When Claude discovers project
       "Grep",
       "WebSearch",
       "WebFetch",
+      "Bash(npm test)",
+      "Bash(npm test *)",
       "Bash(npm run dev)",
       "Bash(npm run build)",
       "Bash(npm run lint)",
@@ -2093,23 +2096,25 @@ Claude reads this file but must never write to it. When Claude discovers project
       "Bash(npm run test:*)",
       "Bash(npm run validate)",
       "Bash(git status)",
-      "Bash(git diff:*)",
-      "Bash(git add:*)",
-      "Bash(git commit:*)",
-      "Bash(git push:*)",
+      "Bash(git status *)",
+      "Bash(git diff *)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Bash(git push *)",
       "Bash(git pull)",
-      "Bash(git checkout:*)",
-      "Bash(git branch:*)",
-      "Bash(ls:*)",
-      "Bash(dir:*)",
-      "Bash(mkdir:*)",
-      "Bash(mkdir -p:*)",
-      "Bash(start:*)",
-      "Bash(start .claude:*)",
-      "Bash(open:*)",
-      "Bash(open .claude:*)",
-      "Bash(xdg-open:*)",
-      "Bash(xdg-open .claude:*)"
+      "Bash(git pull *)",
+      "Bash(git checkout *)",
+      "Bash(git branch *)",
+      "Bash(ls *)",
+      "Bash(dir *)",
+      "Bash(mkdir *)",
+      "Bash(mkdir -p *)",
+      "Bash(start *)",
+      "Bash(start .claude *)",
+      "Bash(open *)",
+      "Bash(open .claude *)",
+      "Bash(xdg-open *)",
+      "Bash(xdg-open .claude *)"
     ],
     "deny": [
       "Read(./.env)",
@@ -2118,9 +2123,9 @@ Claude reads this file but must never write to it. When Claude discovers project
       "Read(./**/credentials.*)",
       "Read(./**/*.pem)",
       "Read(./**/*.key)",
-      "Bash(rm -rf:*)",
-      "Bash(curl:*)",
-      "Bash(wget:*)"
+      "Bash(rm -rf *)",
+      "Bash(curl *)",
+      "Bash(wget *)"
     ]
   }
 }`

package/.claude/scripts/sync-docs.js

@@ -81,6 +81,29 @@ function extractDescription(content, ext) {
   return null;
 }
 
+/**
+ * Extract usage lines from a command file's content.
+ * Looks for a "Usage:" section and collects the bullet points.
+ */
+function extractUsage(content) {
+  const lines = content.split(/\r?\n/);
+  const usageIdx = lines.findIndex(l => /^Usage:$/i.test(l.trim()));
+  if (usageIdx === -1) return null;
+
+  const usageLines = [];
+  for (let i = usageIdx + 1; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (line.startsWith('- ')) {
+      usageLines.push(line);
+    } else if (line === '') {
+      continue; // skip blank lines within usage block
+    } else {
+      break; // end of usage block
+    }
+  }
+  return usageLines.length > 0 ? usageLines.join('\\n') : null;
+}
+
 /**
  * Extract @trigger from a JS file's JSDoc.
  */
@@ -170,8 +193,9 @@ function scanFiles() {
       const desc = extractDescription(content, ext) || `${file} in ${folder}/`;
       const trigger = deriveTrigger(folder, file, content);
       const preview = generatePreview(content, ext);
+      const usage = (folder === 'commands') ? extractUsage(content) : null;
 
-      entries.push({ key, folder, file, desc, trigger, preview });
+      entries.push({ key, folder, file, desc, trigger, preview, usage });
     }
   }
 
@@ -317,7 +341,11 @@ function generateTreeInfo(entries) {
   for (const entry of entries) {
     if (entry.isEmptyFolder) continue;
 
-    const escapedDesc = entry.desc.replace(/'/g, "\\'");
+    let fullDesc = entry.desc;
+    if (entry.usage) {
+      fullDesc += '\\n\\n' + entry.usage;
+    }
+    const escapedDesc = fullDesc.replace(/'/g, "\\'");
     lines.push(`            '${entry.key}': {`);
     lines.push(`                title: '${entry.file}',`);
     lines.push(`                desc: '${escapedDesc}'${entry.trigger ? ',' : ''}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-autoconfig",
-  "version": "1.0.137",
+  "version": "1.0.138",
   "description": "Intelligent, self-configuring setup for Claude Code. One command analyzes your project, configures Claude, and shows you what it did.",
   "author": "ADAC 1001 <info@adac1001.com>",
   "license": "MIT",