claude-code-autoconfig 1.0.136 → 1.0.138

package/.claude/commands/recover-context.md

@@ -1,14 +1,15 @@
 <!-- @description Recovers conversation context from the session transcript after compaction. -->
-<!-- @version 2 -->
+<!-- @version 3 -->
 Recover recent conversation context from the raw session transcript on disk.
 
 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
 

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.',
+                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
 
@@ -2047,82 +2048,86 @@ Claude reads this file but must never write to it. When Claude discovers project
             },
             'settings': {
                 filename: 'settings.json',
-                content: `{
-  "env": {
-    "CLAUDE_CODE_DISABLE_AUTO_MEMORY": "0"
-  },
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .claude/hooks/migrate-feedback.js"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .claude/hooks/feedback-rule-check.js"
-          }
-        ]
-      }
-    ]
-  },
-  "permissions": {
-    "allow": [
-      "Read(./**)",
-      "Edit(./**)",
-      "Write(./**)",
-      "Glob",
-      "Grep",
-      "WebSearch",
-      "WebFetch",
-      "Bash(npm run dev)",
-      "Bash(npm run build)",
-      "Bash(npm run lint)",
-      "Bash(npm run lint:fix)",
-      "Bash(npm run typecheck)",
-      "Bash(npm run test)",
-      "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 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)",
-      "Read(./.env.*)",
-      "Read(./secrets/**)",
-      "Read(./**/credentials.*)",
-      "Read(./**/*.pem)",
-      "Read(./**/*.key)",
-      "Bash(rm -rf:*)",
-      "Bash(curl:*)",
-      "Bash(wget:*)"
-    ]
-  }
+                content: `{
+  "env": {
+    "CLAUDE_CODE_DISABLE_AUTO_MEMORY": "0"
+  },
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/migrate-feedback.js"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/feedback-rule-check.js"
+          }
+        ]
+      }
+    ]
+  },
+  "permissions": {
+    "allow": [
+      "Read(./**)",
+      "Edit(./**)",
+      "Write(./**)",
+      "Glob",
+      "Grep",
+      "WebSearch",
+      "WebFetch",
+      "Bash(npm test)",
+      "Bash(npm test *)",
+      "Bash(npm run dev)",
+      "Bash(npm run build)",
+      "Bash(npm run lint)",
+      "Bash(npm run lint:fix)",
+      "Bash(npm run typecheck)",
+      "Bash(npm run test)",
+      "Bash(npm run test:*)",
+      "Bash(npm run validate)",
+      "Bash(git status)",
+      "Bash(git status *)",
+      "Bash(git diff *)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Bash(git push *)",
+      "Bash(git pull)",
+      "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)",
+      "Read(./.env.*)",
+      "Read(./secrets/**)",
+      "Read(./**/credentials.*)",
+      "Read(./**/*.pem)",
+      "Read(./**/*.key)",
+      "Bash(rm -rf *)",
+      "Bash(curl *)",
+      "Bash(wget *)"
+    ]
+  }
 }`
             },
             'mcp': {

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.136",
+  "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",