claude-code-autoconfig 1.0.94 → 1.0.95

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 (2) hide show
  1. package/README.md +50 -6
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,9 +1,24 @@
1
+ [![npm version](https://img.shields.io/npm/v/claude-code-autoconfig.svg)](https://www.npmjs.com/package/claude-code-autoconfig)
2
+ [![npm downloads](https://img.shields.io/npm/dw/claude-code-autoconfig.svg)](https://www.npmjs.com/package/claude-code-autoconfig)
3
+ [![license](https://img.shields.io/npm/l/claude-code-autoconfig.svg)](https://github.com/design-and-deliver/claude-code-autoconfig/blob/main/LICENSE)
4
+
1
5
  # Claude Code Autoconfig
2
6
 
3
7
  Intelligent, self-configuring setup for Claude Code. One command analyzes your project, configures Claude, and shows you what it did.
4
8
 
9
+ ## Why
10
+
11
+ Claude Code is powerful out of the box, but every new project means manually writing CLAUDE.md, configuring settings.json, setting up slash commands, and tuning permissions for your stack. It's repetitive, easy to get wrong, and most developers skip it entirely — leaving Claude underinformed about their project.
12
+
13
+ **Autoconfig does it in one step.** Run `/autoconfig` and Claude scans your project, detects your tech stack, and generates a tailored configuration. No templates to fill in. No boilerplate to copy-paste.
14
+
5
15
  ## Quick Install
6
16
 
17
+ **npm:**
18
+ ```bash
19
+ npx claude-code-autoconfig
20
+ ```
21
+
7
22
  **macOS / Linux / WSL:**
8
23
  ```bash
9
24
  curl -fsSL https://raw.githubusercontent.com/design-and-deliver/claude-code-autoconfig/main/install.sh | bash
@@ -29,15 +44,22 @@ your-project/
29
44
  └── .claude/
30
45
  ├── commands/ # Slash commands
31
46
  │ ├── autoconfig.md # /autoconfig - self-configures
47
+ │ ├── autoconfig-update.md # /autoconfig-update - install updates
32
48
  │ ├── commit-and-push.md # /commit-and-push - git workflow
33
49
  │ ├── enable-retro.md # /enable-retro - opt-in tech debt tracking
34
- │ ├── show-docs.md # /show-docs - interactive walkthrough
50
+ │ ├── show-docs.md # /show-docs - interactive walkthrough
35
51
  │ ├── sync-claude-md.md # /sync-claude-md - update CLAUDE.md
36
52
  │ └── test.md # /test - run tests
53
+ ├── agents/ # Agent definitions
54
+ │ ├── create-retro-item.md # Retro item creation agent
55
+ │ └── docs-refresh.md # Docs sync agent
37
56
  ├── feedback/ # Team corrections for Claude
38
57
  │ └── FEEDBACK.md # Add entries when Claude errs
58
+ ├── hooks/ # Hook scripts
59
+ │ └── format.js # Auto-format on Write/Edit
39
60
  ├── docs/ # Interactive documentation
40
61
  │ └── autoconfig.docs.html # Open with /show-docs
62
+ ├── updates/ # Pending config updates
41
63
  ├── rules/ # Path-scoped context (empty)
42
64
  ├── .mcp.json # MCP server configs (empty placeholder)
43
65
  └── settings.json # Permissions & security
@@ -47,28 +69,49 @@ your-project/
47
69
 
48
70
  ### Self-Configuration
49
71
 
50
- Most templates are static — copy, paste, manually fill in.
72
+ Most Claude Code templates are static — copy, paste, manually fill in the blanks. If your project changes, your config is already stale.
51
73
 
52
- This one is **self-configuring**. Run `/autoconfig` and Claude:
74
+ Autoconfig is **self-configuring**. Run `/autoconfig` and Claude:
53
75
 
54
76
  1. **Detects your environment** — Windows vs macOS/Linux for correct command syntax
55
77
  2. **Scans your project** — Package files, framework indicators, test setup
56
78
  3. **Populates CLAUDE.md** — Project name, tech stack, commands, conventions
57
79
  4. **Configures settings.json** — Permissions tuned to your ecosystem
58
80
 
59
- You get a custom-fit configuration without the manual work.
81
+ Run `/sync-claude-md` anytime your project evolves to keep the configuration current.
60
82
 
61
83
  ### Slash Commands
62
84
 
63
85
  | Command | Description |
64
86
  |---------|-------------|
65
87
  | `/autoconfig` | Analyzes project and populates configuration |
88
+ | `/autoconfig-update` | Check for and install configuration updates |
66
89
  | `/sync-claude-md` | Re-analyzes project and updates CLAUDE.md |
67
90
  | `/show-docs` | Opens interactive docs in browser |
68
91
  | `/test` | Runs your test suite (auto-detects framework) |
69
92
  | `/commit-and-push` | Stages, commits with good message, and pushes |
70
93
  | `/enable-retro` | (Experimental) Enable tech debt tracking |
71
94
 
95
+ ### Updates
96
+
97
+ When new features or improvements are released, just run the install again:
98
+
99
+ ```bash
100
+ npx claude-code-autoconfig@latest
101
+ ```
102
+
103
+ Autoconfig detects existing installations and automatically launches `/autoconfig-update` instead of a full reconfigure. Your customizations (feedback, hooks, settings) are preserved — only new files are added.
104
+
105
+ Use `--force` for a clean slate reset if needed:
106
+
107
+ ```bash
108
+ npx claude-code-autoconfig@latest --force
109
+ ```
110
+
111
+ ### MEMORY.md
112
+
113
+ Autoconfig writes a debug methodology to Claude's persistent memory (`MEMORY.md`), ensuring Claude investigates root causes with evidence before jumping to fixes. This loads into every future session automatically.
114
+
72
115
  ### Team Feedback
73
116
 
74
117
  When Claude makes a mistake, add an entry to `.claude/feedback/FEEDBACK.md`:
@@ -108,15 +151,16 @@ The included `settings.json` provides sensible defaults that balance productivit
108
151
  - **`allow`** — Auto-approved operations (file edits, tests, git commands)
109
152
  - **`deny`** — Always blocked (secrets, destructive commands, network calls)
110
153
 
111
- Review and adjust these for your team's needs. Run `/permissions` in Claude Code to inspect your current configuration.
154
+ Review and adjust these for your team's needs.
112
155
 
113
156
  See [Claude Code Security Docs](https://docs.anthropic.com/en/docs/claude-code/security) for best practices.
114
157
 
115
158
  ## Links
116
159
 
160
+ - [npm package](https://www.npmjs.com/package/claude-code-autoconfig)
117
161
  - [Claude Code Docs](https://docs.anthropic.com/en/docs/claude-code/overview)
118
162
  - [Slash Commands Reference](https://docs.anthropic.com/en/docs/claude-code/slash-commands)
119
163
 
120
164
  ---
121
165
 
122
- Built by [ADAC 1001](https://adac1001.com)
166
+ Built by [Andrew Ciccarelli](https://www.linkedin.com/in/andrewciccarelli/) at [ADAC 1001](https://adac1001.com) — a solo dev who ships.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-code-autoconfig",
3
- "version": "1.0.94",
3
+ "version": "1.0.95",
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",