claude-code-autoconfig 1.0.166 → 1.0.168
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.
- package/.claude/commands/autoconfig-update.md +1 -1
- package/.claude/docs/autoconfig.docs.html +14 -57
- package/CHANGELOG.md +6 -6
- package/CLAUDE.md +39 -39
- package/README.md +0 -4
- package/package.json +2 -2
- package/.claude/commands/sync-claude-md.md +0 -46
|
@@ -147,5 +147,5 @@ Then delete the `.claude/updates/` directory (it's ephemeral — updates are tra
|
|
|
147
147
|
If the user installed any updates that modified `.claude/commands/autoconfig.md`, suggest:
|
|
148
148
|
|
|
149
149
|
```
|
|
150
|
-
Run /
|
|
150
|
+
Run /autoconfig to apply these changes to your current project.
|
|
151
151
|
```
|
|
@@ -903,11 +903,6 @@
|
|
|
903
903
|
<span class="tree-file-icon">📄</span>
|
|
904
904
|
<span class="file">show-docs.md</span>
|
|
905
905
|
</div>
|
|
906
|
-
<div class="tree-item indent-3 hidden" data-info="sync-claude-md" data-parent="commands">
|
|
907
|
-
<span class="tree-spacer"></span>
|
|
908
|
-
<span class="tree-file-icon">📄</span>
|
|
909
|
-
<span class="file">sync-claude-md.md</span>
|
|
910
|
-
</div>
|
|
911
906
|
<div class="tree-item indent-3 hidden" data-info="test" data-parent="commands">
|
|
912
907
|
<span class="tree-spacer"></span>
|
|
913
908
|
<span class="tree-file-icon">📄</span>
|
|
@@ -1268,7 +1263,7 @@
|
|
|
1268
1263
|
title: '.claude/ Directory',
|
|
1269
1264
|
desc: 'Commands, rules, settings, and these docs. Keeps configuration organized as your project grows.'
|
|
1270
1265
|
},
|
|
1271
|
-
|
|
1266
|
+
'rules': {
|
|
1272
1267
|
title: 'rules/',
|
|
1273
1268
|
desc: 'Path-scoped context that loads when Claude works on matching files.'
|
|
1274
1269
|
},
|
|
@@ -1290,27 +1285,27 @@
|
|
|
1290
1285
|
},
|
|
1291
1286
|
'autoconfig-update': {
|
|
1292
1287
|
title: 'autoconfig-update.md',
|
|
1293
|
-
desc: 'Manages and installs updates to Claude Code configuration.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>updates-available</code></td><td style="padding: 4px 8px;">Displays list of pending updates with install/review options.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>up-to-date</code></td><td style="padding: 4px 8px;">All updates are already installed.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Pulls latest update files from npm, executes update instructions, tracks applied updates</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/autoconfig-update</code> <span style="opacity: 0.6;">— Check for and install configuration updates</span></div></div></div>',
|
|
1288
|
+
desc: 'Manages and installs updates to Claude Code configuration.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>updates-available</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Displays list of pending updates with install/review options.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>up-to-date</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">All updates are already installed.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Pulls latest update files from npm, executes update instructions, tracks applied updates</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/autoconfig-update</code> <span style="opacity: 0.6;">— Check for and install configuration updates</span></div></div></div>',
|
|
1294
1289
|
trigger: '/autoconfig-update'
|
|
1295
1290
|
},
|
|
1296
1291
|
'autoconfig': {
|
|
1297
1292
|
title: 'autoconfig.md',
|
|
1298
|
-
desc: 'Configures Claude Code scaffolding for your project. Sets up settings, permissions, hooks, commands, and docs.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Scaffolding configured, CLAUDE.md initialized, docs opened in browser.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-project</code></td><td style="padding: 4px 8px;">No project detected — asks user to confirm directory.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Initializes CLAUDE.md, settings.json, hooks, commands, and MEMORY.md</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/autoconfig</code> <span style="opacity: 0.6;">— Analyze project and configure Claude</span></div></div></div>',
|
|
1293
|
+
desc: 'Configures Claude Code scaffolding for your project. Sets up settings, permissions, hooks, commands, and docs.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Scaffolding configured, CLAUDE.md initialized, docs opened in browser.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>no-project</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">No project detected — asks user to confirm directory.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Initializes CLAUDE.md, settings.json, hooks, commands, and MEMORY.md</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/autoconfig</code> <span style="opacity: 0.6;">— Analyze project and configure Claude</span></div></div></div>',
|
|
1299
1294
|
trigger: '/autoconfig'
|
|
1300
1295
|
},
|
|
1301
1296
|
'commit-and-push': {
|
|
1302
1297
|
title: 'commit-and-push.md',
|
|
1303
|
-
desc: 'Runs tests, then stages all changes, generates a conventional commit message, commits, and pushes.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Changes committed and pushed to current branch.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>test-failure</code></td><td style="padding: 4px 8px;">Tests failed — no commit made.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Runs test suite, stages all changes, creates git commit, pushes to remote</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/commit-and-push</code> <span style="opacity: 0.6;">— Run tests, commit, and push</span></div></div></div>',
|
|
1298
|
+
desc: 'Runs tests, then stages all changes, generates a conventional commit message, commits, and pushes.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Changes committed and pushed to current branch.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>test-failure</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Tests failed — no commit made.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Runs test suite, stages all changes, creates git commit, pushes to remote</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/commit-and-push</code> <span style="opacity: 0.6;">— Run tests, commit, and push</span></div></div></div>',
|
|
1304
1299
|
trigger: '/commit-and-push'
|
|
1305
1300
|
},
|
|
1306
1301
|
'enable-retro': {
|
|
1307
1302
|
title: 'enable-retro.md',
|
|
1308
|
-
desc: '(Experimental) Enable Claude to log tech debt it encounters into .claude/retro.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Retro enabled — Claude will log tech debt to .claude/retro/ when encountered.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Creates .claude/retro/README.md, adds agent, updates CLAUDE.md</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/enable-retro</code> <span style="opacity: 0.6;">— Activate tech debt tracking</span></div></div></div>',
|
|
1303
|
+
desc: '(Experimental) Enable Claude to log tech debt it encounters into .claude/retro.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Retro enabled — Claude will log tech debt to .claude/retro/ when encountered.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Creates .claude/retro/README.md, adds agent, updates CLAUDE.md</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/enable-retro</code> <span style="opacity: 0.6;">— Activate tech debt tracking</span></div></div></div>',
|
|
1309
1304
|
trigger: '/enable-retro'
|
|
1310
1305
|
},
|
|
1311
1306
|
'gls': {
|
|
1312
1307
|
title: 'gls.md',
|
|
1313
|
-
desc: 'Get the latest screenshot(s) and display them.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Name</th><th style="padding: 4px 8px;">Type</th><th style="padding: 4px 8px;">Required</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>count</code></td><td style="padding: 4px 8px;"><code>integer</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">Number of screenshots to display. Use /gls-N syntax. Default: 1. Min: 1.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>path</code></td><td style="padding: 4px 8px;"><code>string</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">Screenshot directory path. Saved for future use. Auto-detected if omitted.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Displays requested screenshot(s) from newest to oldest.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-screenshots</code></td><td style="padding: 4px 8px;">Directory exists but contains no image files.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-directory</code></td><td style="padding: 4px 8px;">Unable to detect screenshot directory — prompts for path.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Saves detected screenshot path to
|
|
1308
|
+
desc: 'Get the latest screenshot(s) and display them.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Name</th><th style="padding: 4px 8px 4px 0;">Type</th><th style="padding: 4px 8px 4px 0;">Required</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>count</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;"><code>integer</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">optional</td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Number of screenshots to display. Use /gls-N syntax. Default: 1. Min: 1.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>path</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;"><code>string</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">optional</td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Screenshot directory path. Saved for future use. Auto-detected if omitted.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Displays requested screenshot(s) from newest to oldest.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>no-screenshots</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Directory exists but contains no image files.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>no-directory</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Unable to detect screenshot directory — prompts for path.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Saves detected screenshot path to .claude/cca.config.json on first run</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/gls</code> <span style="opacity: 0.6;">— Display the most recent screenshot</span></div><div><code>/gls-3</code> <span style="opacity: 0.6;">— Display the 3 most recent screenshots</span></div><div><code>/gls /path/to/dir</code> <span style="opacity: 0.6;">— Use a specific screenshot directory</span></div></div></div>',
|
|
1314
1309
|
trigger: '/gls'
|
|
1315
1310
|
},
|
|
1316
1311
|
'publish': {
|
|
@@ -1320,27 +1315,22 @@
|
|
|
1320
1315
|
},
|
|
1321
1316
|
'recover-context': {
|
|
1322
1317
|
title: 'recover-context.md',
|
|
1323
|
-
desc: 'Recovers conversation context from the session transcript after compaction.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Name</th><th style="padding: 4px 8px;">Type</th><th style="padding: 4px 8px;">Required</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>minutes</code></td><td style="padding: 4px 8px;"><code>integer</code></td><td style="padding: 4px 8px;">required</td><td style="padding: 4px 8px;">How far back to recover, in minutes. Leading dash optional. Min: 1.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>--show</code></td><td style="padding: 4px 8px;"><code>flag</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">Opens the extracted transcript in your default editor.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">~{tokens} tokens recovered ({N} messages across {sessions} session(s), last {minutes} min).</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-transcript</code></td><td style="padding: 4px 8px;">No transcript files found.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-messages</code></td><td style="padding: 4px 8px;">No messages found in the requested time range.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Reads .jsonl transcripts from ~/.claude/projects/, writes temp file</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/recover-context -60</code> <span style="opacity: 0.6;">— Last 60 minutes of conversation</span></div><div><code>/recover-context 120</code> <span style="opacity: 0.6;">— Last 2 hours (dash optional)</span></div><div><code>/recover-context -60 --show</code> <span style="opacity: 0.6;">— Last 60 min + open transcript file</span></div></div></div>',
|
|
1318
|
+
desc: 'Recovers conversation context from the session transcript after compaction.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Name</th><th style="padding: 4px 8px 4px 0;">Type</th><th style="padding: 4px 8px 4px 0;">Required</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>minutes</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;"><code>integer</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">required</td><td style="padding: 4px 8px 4px 0; vertical-align: top;">How far back to recover, in minutes. Leading dash optional. Min: 1.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>--show</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;"><code>flag</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">optional</td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Opens the extracted transcript in your default editor.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">~{tokens} tokens recovered ({N} messages across {sessions} session(s), last {minutes} min).</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>no-transcript</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">No transcript files found.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>no-messages</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">No messages found in the requested time range.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Reads .jsonl transcripts from ~/.claude/projects/, writes temp file</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/recover-context -60</code> <span style="opacity: 0.6;">— Last 60 minutes of conversation</span></div><div><code>/recover-context 120</code> <span style="opacity: 0.6;">— Last 2 hours (dash optional)</span></div><div><code>/recover-context -60 --show</code> <span style="opacity: 0.6;">— Last 60 min + open transcript file</span></div></div></div>',
|
|
1324
1319
|
trigger: '/recover-context'
|
|
1325
1320
|
},
|
|
1326
1321
|
'show-docs': {
|
|
1327
1322
|
title: 'show-docs.md',
|
|
1328
|
-
desc: 'Opens the interactive docs in your browser.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Docs synced and opened in default browser.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>no-docs</code></td><td style="padding: 4px 8px;">Docs file not found — run /autoconfig first.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Runs sync-docs.js to refresh content, opens browser</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/show-docs</code> <span style="opacity: 0.6;">— Open interactive documentation</span></div></div></div>',
|
|
1323
|
+
desc: 'Opens the interactive docs in your browser.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Docs synced and opened in default browser.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>no-docs</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Docs file not found — run /autoconfig first.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Runs sync-docs.js to refresh content, opens browser</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/show-docs</code> <span style="opacity: 0.6;">— Open interactive documentation</span></div></div></div>',
|
|
1329
1324
|
trigger: '/show-docs'
|
|
1330
1325
|
},
|
|
1331
|
-
'sync-claude-md': {
|
|
1332
|
-
title: 'sync-claude-md.md',
|
|
1333
|
-
desc: 'Ensures CLAUDE.md has the required markers and Discoveries section.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">CLAUDE.md verified and updated if needed.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">May add markers or Discoveries section if missing, preserves all existing content</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/sync-claude-md</code> <span style="opacity: 0.6;">— Verify CLAUDE.md structure</span></div></div></div>',
|
|
1334
|
-
trigger: '/sync-claude-md'
|
|
1335
|
-
},
|
|
1336
1326
|
'test': {
|
|
1337
1327
|
title: 'test.md',
|
|
1338
|
-
desc: 'Runs your test suite. Auto-detects Jest, Vitest, Pytest, Go, RSpec, or falls back to npm test.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Name</th><th style="padding: 4px 8px;">Type</th><th style="padding: 4px 8px;">Required</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>scope</code></td><td style="padding: 4px 8px;"><code>string</code></td><td style="padding: 4px 8px;">optional</td><td style="padding: 4px 8px;">File, directory, or pattern to limit test run. Runs full suite if omitted.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px;">Test suite passes.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>failure</code></td><td style="padding: 4px 8px;">Test suite fails with non-zero exit code.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Executes detected test runner command</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/test</code> <span style="opacity: 0.6;">— Run full test suite</span></div><div><code>/test src/auth</code> <span style="opacity: 0.6;">— Run tests in src/auth directory</span></div><div><code>/test --coverage</code> <span style="opacity: 0.6;">— Run tests with coverage report</span></div></div></div>',
|
|
1328
|
+
desc: 'Runs your test suite. Auto-detects Jest, Vitest, Pytest, Go, RSpec, or falls back to npm test.<div style="margin-top: 12px;"><strong>Parameters</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Name</th><th style="padding: 4px 8px 4px 0;">Type</th><th style="padding: 4px 8px 4px 0;">Required</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>scope</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;"><code>string</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">optional</td><td style="padding: 4px 8px 4px 0; vertical-align: top;">File, directory, or pattern to limit test run. Runs full suite if omitted.</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Test suite passes.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>failure</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Test suite fails with non-zero exit code.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Executes detected test runner command</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/test</code> <span style="opacity: 0.6;">— Run full test suite</span></div><div><code>/test src/auth</code> <span style="opacity: 0.6;">— Run tests in src/auth directory</span></div><div><code>/test --coverage</code> <span style="opacity: 0.6;">— Run tests with coverage report</span></div></div></div>',
|
|
1339
1329
|
trigger: '/test'
|
|
1340
1330
|
},
|
|
1341
1331
|
'validate-cca-install': {
|
|
1342
1332
|
title: 'validate-cca-install.md',
|
|
1343
|
-
desc: 'Validates your claude-code-autoconfig installation against the latest published version.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px;">Status</th><th style="padding: 4px 8px;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>valid</code></td><td style="padding: 4px 8px;">Install validated — all checks passed.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px; white-space: nowrap;"><code>issues</code></td><td style="padding: 4px 8px;">Validation found {N} issue(s) with fix suggestions.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Read-only. Downloads latest package to temp dir for comparison, then cleans up.</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/validate-cca-install</code> <span style="opacity: 0.6;">— Run full installation validation</span></div></div></div>',
|
|
1333
|
+
desc: 'Validates your claude-code-autoconfig installation against the latest published version.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="width: 100%; margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>valid</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Install validated — all checks passed.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>issues</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Validation found {N} issue(s) with fix suggestions.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Read-only. Downloads latest package to temp dir for comparison, then cleans up.</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/validate-cca-install</code> <span style="opacity: 0.6;">— Run full installation validation</span></div></div></div>',
|
|
1344
1334
|
trigger: '/validate-cca-install'
|
|
1345
1335
|
},
|
|
1346
1336
|
'create-retro-item-agent': {
|
|
@@ -1579,7 +1569,7 @@ CRITICAL: A plausible-looking cause from code reading is NOT confirmed evidence.
|
|
|
1579
1569
|
|
|
1580
1570
|
> Run \`/autoconfig\` to populate this based on your project.`
|
|
1581
1571
|
},
|
|
1582
|
-
|
|
1572
|
+
'autoconfig-update': {
|
|
1583
1573
|
filename: 'autoconfig-update.md',
|
|
1584
1574
|
content: `<!-- @applied
|
|
1585
1575
|
-->
|
|
@@ -1713,9 +1703,9 @@ Usage:
|
|
|
1713
1703
|
|
|
1714
1704
|
## Step 1: Check for saved path
|
|
1715
1705
|
|
|
1716
|
-
|
|
1706
|
+
Read \`.claude/cca.config.json\` in the project root. If it exists and contains a \`gls.screenshotDir\` value, use that path and skip to Step 3.
|
|
1717
1707
|
|
|
1718
|
-
If
|
|
1708
|
+
If the file doesn't exist or the key is missing, continue to Step 2.
|
|
1719
1709
|
|
|
1720
1710
|
## Step 2: Detect screenshot directory
|
|
1721
1711
|
|
|
@@ -1731,7 +1721,7 @@ OS=$(uname -s); echo "OS=$OS"; for d in \\
|
|
|
1731
1721
|
"$HOME/Pictures" \\
|
|
1732
1722
|
"$HOME/Videos/Captures"; do \\
|
|
1733
1723
|
[ -d "$d" ] || continue; \\
|
|
1734
|
-
newest=$(ls -t "$d"
|
|
1724
|
+
newest=$(ls -t "$d/" 2>/dev/null | grep -iE '\\.(png|jpg|jpeg|bmp|webp|gif)$' | head -1); \\`
|
|
1735
1725
|
},
|
|
1736
1726
|
'publish': {
|
|
1737
1727
|
filename: 'publish.md',
|
|
@@ -1822,39 +1812,6 @@ Open the docs in the default browser. Use the command matching the current OS:
|
|
|
1822
1812
|
- **Windows:** \`powershell -NoProfile -Command "Start-Process '.claude/docs/autoconfig.docs.html'"\`
|
|
1823
1813
|
|
|
1824
1814
|
**Important:** If the command exits with a non-zero exit code or produces an error, tell the user the file failed to open and suggest they open it manually. Do NOT report success unless the command completed without error.`
|
|
1825
|
-
},
|
|
1826
|
-
'sync-claude-md': {
|
|
1827
|
-
filename: 'sync-claude-md.md',
|
|
1828
|
-
content: `# Sync CLAUDE.md
|
|
1829
|
-
|
|
1830
|
-
Verify that CLAUDE.md has the required structure. This command does NOT populate project descriptions — CLAUDE.md grows organically through Discoveries as you work. Claude can read your config files directly.
|
|
1831
|
-
|
|
1832
|
-
## Step 1: Check for Team Feedback
|
|
1833
|
-
|
|
1834
|
-
Read \`.claude/feedback/FEEDBACK.md\` for any corrections or guidance from the team. Note any relevant entries.
|
|
1835
|
-
|
|
1836
|
-
## Step 2: Verify CLAUDE.md Structure
|
|
1837
|
-
|
|
1838
|
-
Check that CLAUDE.md exists and has the required elements:
|
|
1839
|
-
|
|
1840
|
-
1. **Auto-generated markers** — ensure these exist:
|
|
1841
|
-
\`\`\`markdown
|
|
1842
|
-
<!-- AUTO-GENERATED BY /autoconfig at {TIMESTAMP} UTC -->
|
|
1843
|
-
...
|
|
1844
|
-
<!-- END AUTO-GENERATED at {TIMESTAMP} UTC -->
|
|
1845
|
-
\`\`\`
|
|
1846
|
-
|
|
1847
|
-
2. **Team Feedback pointer** — between the markers:
|
|
1848
|
-
\`\`\`markdown
|
|
1849
|
-
## Team Feedback
|
|
1850
|
-
The contents of \`.claude/feedback/FEEDBACK.md\` are an extension of this file.
|
|
1851
|
-
Read it at the start of every session before taking any action.
|
|
1852
|
-
FEEDBACK.md is reserved for human-authored corrections only — do not write to it.
|
|
1853
|
-
\`\`\`
|
|
1854
|
-
|
|
1855
|
-
3. **Discoveries section** — below the end marker:
|
|
1856
|
-
\`\`\`markdown
|
|
1857
|
-
## Discoveries`
|
|
1858
1815
|
},
|
|
1859
1816
|
'test': {
|
|
1860
1817
|
filename: 'test.md',
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## v1.0.168
|
|
4
|
+
- feat: remove /sync-claude-md command
|
|
5
|
+
|
|
6
|
+
## v1.0.167
|
|
7
|
+
- fix: postversion creates separate commit instead of amending
|
|
8
|
+
|
|
3
9
|
## v1.0.165
|
|
4
10
|
- debug: add temporary changelog debug logging
|
|
5
11
|
|
|
@@ -141,9 +147,3 @@
|
|
|
141
147
|
## v1.0.119
|
|
142
148
|
- fix: remove nul deny rules that block Windows bash redirections
|
|
143
149
|
|
|
144
|
-
## v1.0.118
|
|
145
|
-
- feat: add feedback-to-rules migration update (003)
|
|
146
|
-
|
|
147
|
-
## v1.0.117
|
|
148
|
-
- refactor: let Claude evaluate rule migration candidates
|
|
149
|
-
|
package/CLAUDE.md
CHANGED
|
@@ -1,42 +1,42 @@
|
|
|
1
|
-
<!-- AUTO-GENERATED BY /autoconfig at 2026-01-14 19:54:27 UTC — Do not edit. Use .claude/feedback/ for corrections. -->
|
|
2
|
-
|
|
3
|
-
# claude-code-autoconfig
|
|
4
|
-
|
|
5
|
-
CLI tool that auto-configures Claude Code for any project. One command analyzes your project, configures Claude, and shows you what it did.
|
|
6
|
-
|
|
7
|
-
## Tech Stack
|
|
8
|
-
|
|
9
|
-
- **Runtime:** Node.js (>=16.0.0)
|
|
10
|
-
- **Type:** npm CLI package
|
|
11
|
-
- **Entry:** `bin/cli.js`
|
|
12
|
-
|
|
13
|
-
## Commands
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
npm test # Run all tests (box alignment + CLI install)
|
|
17
|
-
npm run test:box # Run box alignment tests only
|
|
18
|
-
npm run test:install # Run CLI install tests only
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
## Project Structure
|
|
22
|
-
|
|
23
|
-
- `bin/cli.js` — Main CLI entry point, handles bootstrap and /autoconfig launch
|
|
24
|
-
- `.claude/commands/` — Slash command definitions (/autoconfig, /
|
|
25
|
-
- `.claude/hooks/` — Hook scripts (format.js for JS/TS projects)
|
|
26
|
-
- `.claude/feedback/` — Team feedback and corrections
|
|
27
|
-
- `test/` — Test files
|
|
28
|
-
|
|
29
|
-
## Publishing
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
npm version patch && npm publish
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
## Team Feedback
|
|
36
|
-
|
|
37
|
-
See `.claude/feedback/` for corrections and guidance from the team.
|
|
38
|
-
|
|
39
|
-
<!-- END AUTO-GENERATED at 2026-01-14 19:54:27 UTC — Use .claude/feedback/ for corrections. -->
|
|
1
|
+
<!-- AUTO-GENERATED BY /autoconfig at 2026-01-14 19:54:27 UTC — Do not edit. Use .claude/feedback/ for corrections. -->
|
|
2
|
+
|
|
3
|
+
# claude-code-autoconfig
|
|
4
|
+
|
|
5
|
+
CLI tool that auto-configures Claude Code for any project. One command analyzes your project, configures Claude, and shows you what it did.
|
|
6
|
+
|
|
7
|
+
## Tech Stack
|
|
8
|
+
|
|
9
|
+
- **Runtime:** Node.js (>=16.0.0)
|
|
10
|
+
- **Type:** npm CLI package
|
|
11
|
+
- **Entry:** `bin/cli.js`
|
|
12
|
+
|
|
13
|
+
## Commands
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npm test # Run all tests (box alignment + CLI install)
|
|
17
|
+
npm run test:box # Run box alignment tests only
|
|
18
|
+
npm run test:install # Run CLI install tests only
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
## Project Structure
|
|
22
|
+
|
|
23
|
+
- `bin/cli.js` — Main CLI entry point, handles bootstrap and /autoconfig launch
|
|
24
|
+
- `.claude/commands/` — Slash command definitions (/autoconfig, /autoconfig-update, etc.)
|
|
25
|
+
- `.claude/hooks/` — Hook scripts (format.js for JS/TS projects)
|
|
26
|
+
- `.claude/feedback/` — Team feedback and corrections
|
|
27
|
+
- `test/` — Test files
|
|
28
|
+
|
|
29
|
+
## Publishing
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
npm version patch && npm publish
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## Team Feedback
|
|
36
|
+
|
|
37
|
+
See `.claude/feedback/` for corrections and guidance from the team.
|
|
38
|
+
|
|
39
|
+
<!-- END AUTO-GENERATED at 2026-01-14 19:54:27 UTC — Use .claude/feedback/ for corrections. -->
|
|
40
40
|
|
|
41
41
|
|
|
42
42
|
## Discoveries
|
package/README.md
CHANGED
|
@@ -52,7 +52,6 @@ your-project/
|
|
|
52
52
|
│ ├── gls.md # /gls - view latest screenshot
|
|
53
53
|
│ ├── recover-context.md # /recover-context - restore context after compaction
|
|
54
54
|
│ ├── show-docs.md # /show-docs - interactive walkthrough
|
|
55
|
-
│ ├── sync-claude-md.md # /sync-claude-md - update CLAUDE.md
|
|
56
55
|
│ ├── test.md # /test - run tests
|
|
57
56
|
│ └── validate-cca-install.md # /validate-cca-install - verify installation
|
|
58
57
|
├── agents/ # Agent definitions
|
|
@@ -93,15 +92,12 @@ Autoconfig is **self-configuring**. Run `/autoconfig` and Claude:
|
|
|
93
92
|
| Auto-format hook | Yes | Coming soon |
|
|
94
93
|
| Optimized permissions | Yes | Coming soon |
|
|
95
94
|
|
|
96
|
-
Run `/sync-claude-md` anytime your project evolves to keep the configuration current.
|
|
97
|
-
|
|
98
95
|
### Slash Commands
|
|
99
96
|
|
|
100
97
|
| Command | Description |
|
|
101
98
|
|---------|-------------|
|
|
102
99
|
| `/autoconfig` | Configures Claude Code scaffolding for your project |
|
|
103
100
|
| `/autoconfig-update` | Check for and install configuration updates |
|
|
104
|
-
| `/sync-claude-md` | Verifies CLAUDE.md structure and markers |
|
|
105
101
|
| `/show-docs` | Opens interactive docs in browser |
|
|
106
102
|
| `/test` | Runs your test suite (auto-detects framework) |
|
|
107
103
|
| `/commit-and-push` | Stages, commits with good message, and pushes |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "claude-code-autoconfig",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.168",
|
|
4
4
|
"description": "Intelligent, self-configuring setup for Claude Code. One command analyzes your project, configures Claude, and shows you what it did.",
|
|
5
5
|
"author": "ADAC 1001 <info@adac1001.com>",
|
|
6
6
|
"license": "MIT",
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
"test:box": "node test/box-alignment.test.js",
|
|
27
27
|
"test:install": "node test/cli-install.test.js",
|
|
28
28
|
"test:update": "node test/update-system.test.js",
|
|
29
|
-
"postversion": "node scripts/generate-changelog.js
|
|
29
|
+
"postversion": "node scripts/generate-changelog.js --postversion"
|
|
30
30
|
},
|
|
31
31
|
"bin": {
|
|
32
32
|
"claude-code-autoconfig": "./bin/cli.js"
|
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
<!-- @description Ensures CLAUDE.md has the required markers and Discoveries section. -->
|
|
2
|
-
<!-- @version 3 -->
|
|
3
|
-
<!-- @response success | CLAUDE.md verified and updated if needed. -->
|
|
4
|
-
<!-- @sideeffect May add markers or Discoveries section if missing, preserves all existing content -->
|
|
5
|
-
<!-- @example /sync-claude-md | Verify CLAUDE.md structure -->
|
|
6
|
-
|
|
7
|
-
# Sync CLAUDE.md
|
|
8
|
-
|
|
9
|
-
Verify that CLAUDE.md has the required structure. This command does NOT populate project descriptions — CLAUDE.md grows organically through Discoveries as you work. Claude can read your config files directly.
|
|
10
|
-
|
|
11
|
-
## Step 1: Check for Team Feedback
|
|
12
|
-
|
|
13
|
-
Read `.claude/feedback/FEEDBACK.md` for any corrections or guidance from the team. Note any relevant entries.
|
|
14
|
-
|
|
15
|
-
## Step 2: Verify CLAUDE.md Structure
|
|
16
|
-
|
|
17
|
-
Check that CLAUDE.md exists and has the required elements:
|
|
18
|
-
|
|
19
|
-
1. **Auto-generated markers** — ensure these exist:
|
|
20
|
-
```markdown
|
|
21
|
-
<!-- AUTO-GENERATED BY /autoconfig at {TIMESTAMP} UTC -->
|
|
22
|
-
...
|
|
23
|
-
<!-- END AUTO-GENERATED at {TIMESTAMP} UTC -->
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
2. **Team Feedback pointer** — between the markers:
|
|
27
|
-
```markdown
|
|
28
|
-
## Team Feedback
|
|
29
|
-
The contents of `.claude/feedback/FEEDBACK.md` are an extension of this file.
|
|
30
|
-
Read it at the start of every session before taking any action.
|
|
31
|
-
FEEDBACK.md is reserved for human-authored corrections only — do not write to it.
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
3. **Discoveries section** — below the end marker:
|
|
35
|
-
```markdown
|
|
36
|
-
## Discoveries
|
|
37
|
-
<!-- Claude: append project-specific learnings, gotchas, and context below. This section persists across /autoconfig runs. -->
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
If any of these are missing, add them. **Never remove or overwrite existing content** — especially the Discoveries section, which contains organic learnings from real work.
|
|
41
|
-
|
|
42
|
-
If CLAUDE.md doesn't exist at all, create it with the minimal template from `/autoconfig` Step 1.
|
|
43
|
-
|
|
44
|
-
## Step 3: Confirm
|
|
45
|
-
|
|
46
|
-
Tell the user what was verified or updated. If everything was already in place, say so.
|