Plugin setup

.changeset/auto-00d8d1c8b7d4b9d5.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Removed unused firstSetupRequired field from hook state, simplifying the configuration interface

.changeset/auto-03859f8c212486b9.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Planned upcoming work to wrap the init hint message as a directive

.changeset/auto-07d0cbbbc5cd960b.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Simplified the initialization hint message to a plain one-line reminder for clearer, less intrusive guidance

.changeset/auto-0aeb92648e0f883a.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Planned upcoming fix for skill-name handling

.changeset/auto-103b214fd7e5f524.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Fixed init hint message not appearing in sessions by ensuring Claude surfaces it to the user

.changeset/auto-114006803163210a.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Updated internal planning documentation to reflect completed work

.changeset/auto-13e2896eba0dd5dc.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Renamed skills to use consistent `/claude-auto-*` naming pattern (claude-auto-init and claude-auto-config)

.changeset/auto-18be352e0fd346e0.md

@@ -0,0 +1,6 @@
+---
+"claude-auto": minor
+---
+
+- Added `/claude-auto init` skill that sets up claude-auto in a project with a guided initialization flow
+- Included esbuild bundling configuration for the new init skill entry point

.changeset/auto-2eda8b072fdf990a.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": minor
+---
+
+- Loggers become silent no-ops when the auto directory does not exist, preventing errors in unconfigured environments

.changeset/auto-527d22f7c1158c63.md

@@ -0,0 +1,9 @@
+---
+"claude-auto": minor
+---
+
+- Switched to plugin-only mode, removing the legacy npx/CLI installation system entirely
+- Added plugin marketplace support for easier installation via Claude Code's plugin system
+- Added runtime configuration skill for managing validators and reminders with overrides
+- Fixed path resolution and commit validation settings when running as a plugin
+- Rewrote all documentation for the new plugin-only workflow

.changeset/auto-5a4164dedf5b798c.md

@@ -0,0 +1,6 @@
+---
+"claude-auto": minor
+---
+
+- Refreshed init output with emojis for better readability
+- Removed interrupt directive from init messaging

.changeset/auto-5c66880199819e15.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Updated internal ketchup plan to reflect completed burst 7.4

.changeset/auto-608cf294b022200a.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Planned simplification of the session-start init hint message

.changeset/auto-6cd909f9c1020e67.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Improved hook state initialization to avoid creating unnecessary directories

.changeset/auto-72b5e9ed34f04950.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Marked burst 7.1 as complete in the ketchup plan

.changeset/auto-76da04a23593ce0e.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Updated internal planning notes to reflect completed work

.changeset/auto-7ee4b538ca7b1e61.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Fixed incorrect skill name in initialization hint so users see the correct `/claude-auto-init` command

.changeset/auto-8a3650020678282b.md

@@ -0,0 +1,6 @@
+---
+"claude-auto": minor
+---
+
+- Added `initClaudeAuto` function that sets up the `.claude-auto` directory with default configuration
+- Automatically detects and updates `.gitignore` to exclude generated files

.changeset/auto-8abcc38b44c748f9.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Changed the initialization hint message to be a directive, so Claude now actively mentions the hint to the user in its first response instead of silently absorbing it

.changeset/auto-8d572fc9287f961a.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": minor
+---
+
+- Pre-tool-use and auto-continue hooks now return early when the auto directory is missing, avoiding errors in unconfigured projects

.changeset/auto-9f0c051f2b2f0c71.md

@@ -0,0 +1,8 @@
+---
+"claude-auto": patch
+---
+
+- Updated all documentation to reflect the new opt-in activation model and renamed skills
+- Renamed `/claude-auto:config` to `/claude-auto-config` across all docs
+- Added references to `/claude-auto-init` for opt-in repository activation
+- Updated installation and getting-started guides to reflect the new plugin workflow

.changeset/auto-a276c3aa9bb22e96.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Planned upcoming improvement to wrap the init configuration tip in a directive for better visibility

.changeset/auto-a569e12b1fcfbf53.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Fixed init config tip so Claude reliably surfaces it to users

.changeset/auto-b5b2b91dae49881e.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Updated ketchup plan to reflect completed bursts

.changeset/auto-c36b4f31bff1dd98.md

@@ -0,0 +1,6 @@
+---
+"claude-auto": minor
+---
+
+- Simplified initial setup by removing the first-setup-required flag
+- Hook state now returns sensible defaults when the auto directory doesn't exist yet, preventing errors on fresh installations

.changeset/auto-cc43d2e6e4f7dee7.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Planned non-interrupting init message burst

.changeset/auto-d2443bac99df8c22.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": patch
+---
+
+- Planned emoji-decorated styling for the initialization hint message

.changeset/auto-da5d347ee9523406.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": minor
+---
+
+- Added a prompt after initialization that asks users if they want to review or customize their configuration

.changeset/auto-de781e018e6b3e35.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": minor
+---
+
+- Added emojis to the initialization hint message for better visibility

.changeset/auto-ecd9b8349c13aa41.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": minor
+---
+
+- Added human-readable formatting for init command output

.changeset/auto-ed0bb5e5f8ebb378.md

@@ -0,0 +1,6 @@
+---
+"claude-auto": minor
+---
+
+- Replaced blocking first-setup flow with a non-blocking hint message shown on session start when the project is not yet initialized
+- Hooks now silently return early in uninitialized repos instead of interrupting the user

.changeset/auto-f0f2f04512b4ac0b.md

@@ -0,0 +1,5 @@
+---
+"claude-auto": minor
+---
+
+- Write and update operations now silently skip when the auto directory is missing, preventing errors in unconfigured projects

CLAUDE.md

@@ -71,7 +71,7 @@ Both are markdown files with YAML frontmatter. Validators gate commits (ACK/NACK
 
 ### Installation Model
 
-Claude Auto runs as a Claude Code plugin. Install via `/plugin marketplace add BeOnAuto/auto-plugins` or `claude --plugin-dir /path/to/claude-auto`. The plugin provides validators, reminders, and hook scripts. Projects can add local overrides in `.claude-auto/`.
+Claude Auto runs as a Claude Code plugin. Install via `/plugin marketplace add BeOnAuto/auto-plugins` or `claude --plugin-dir /path/to/claude-auto`. The plugin is opt-in per repository: hooks are inactive until the user runs `/claude-auto-init`, which creates `.claude-auto/` with default config. Without initialization, session-start shows a non-blocking hint. The plugin provides validators, reminders, and hook scripts. Projects can add local overrides in `.claude-auto/`.
 
 ## Coding Patterns
 

README.md

@@ -40,7 +40,7 @@ Inside any Claude Code session:
 claude --plugin-dir /path/to/claude-auto
 ```
 
-Claude Code sets `CLAUDE_PLUGIN_ROOT` and `CLAUDE_PLUGIN_DATA` automatically. Validators and reminders load from the plugin package, with optional project-local overrides from `.claude-auto/`. State and logs go to the project's `.claude-auto/` directory.
+Claude Code sets `CLAUDE_PLUGIN_ROOT` and `CLAUDE_PLUGIN_DATA` automatically. Run `/claude-auto-init` inside a session to activate per-project configuration, validators, and logging.
 
 ## Quick Start
 
@@ -53,11 +53,13 @@ Claude Code sets `CLAUDE_PLUGIN_ROOT` and `CLAUDE_PLUGIN_DATA` automatically. Va
 claude --plugin-dir /path/to/claude-auto
 ```
 
-After installation, Claude Auto automatically:
+After installation, Claude will mention that claude-auto is available. To activate it in a project:
 
-- Injects hooks that validate every commit against your criteria
-- Creates reminders that inject your guidelines into prompts
-- Sets up file protection via deny-lists
+```
+/claude-auto-init
+```
+
+This creates `.claude-auto/` with default configuration. You can add it to `.gitignore` for personal use, or commit it for the whole team.
 
 **Next steps:**
 
@@ -121,10 +123,10 @@ Higher `priority` = appears first. Project-local files are loaded alongside plug
 Toggle validators and reminders without editing files:
 
 ```bash
-/claude-auto:config show
-/claude-auto:config validators disable no-comments
-/claude-auto:config reminders priority my-reminder 200
-/claude-auto:config reminders add my-rule --hook UserPromptSubmit --priority 50 --content "Always use early returns"
+/claude-auto-config show
+/claude-auto-config validators disable no-comments
+/claude-auto-config reminders priority my-reminder 200
+/claude-auto-config reminders add my-rule --hook UserPromptSubmit --priority 50 --content "Always use early returns"
 ```
 
 ---

dist/bundle/scripts/auto-continue.js

@@ -48,6 +48,9 @@ function matchesFilter(hookName, message) {
   return includes.some((pattern) => searchText.includes(pattern));
 }
 function activityLog(autoDir, sessionId, hookName, message) {
+  if (!import_node_fs.default.existsSync(autoDir)) {
+    return;
+  }
   if (!matchesFilter(hookName, message)) {
     return;
   }
@@ -76,6 +79,9 @@ function sanitizeForFilename(hookName) {
   return hookName.replace(/[^a-zA-Z0-9-]/g, "-").toLowerCase();
 }
 function writeHookLog(autoDir, entry) {
+  if (!fs2.existsSync(autoDir)) {
+    return;
+  }
   const logsDir = path2.join(autoDir, "logs", "hooks");
   if (!fs2.existsSync(logsDir)) {
     fs2.mkdirSync(logsDir, { recursive: true });
@@ -125,6 +131,9 @@ function writeHookLog(autoDir, entry) {
 `);
 }
 
+// src/hooks/auto-continue.ts
+var import_node_fs2 = require("node:fs");
+
 // src/hook-state.ts
 var fs3 = __toESM(require("node:fs"));
 var path3 = __toESM(require("node:path"));
@@ -156,22 +165,20 @@ var DEFAULT_HOOK_STATE = {
   }
 };
 function createHookState(autoDir) {
-  if (!fs3.existsSync(autoDir)) {
-    fs3.mkdirSync(autoDir, { recursive: true });
-  }
   const stateFile = path3.join(autoDir, ".claude.hooks.json");
   function read() {
+    if (!fs3.existsSync(autoDir)) {
+      return { ...DEFAULT_HOOK_STATE };
+    }
     if (!fs3.existsSync(stateFile)) {
-      const isPluginMode = !!process.env.CLAUDE_PLUGIN_ROOT;
-      const initialState = isPluginMode ? { ...DEFAULT_HOOK_STATE, firstSetupRequired: true } : { ...DEFAULT_HOOK_STATE };
+      const initialState = { ...DEFAULT_HOOK_STATE };
       fs3.writeFileSync(stateFile, `${JSON.stringify(initialState, null, 2)}
 `);
       return JSON.parse(JSON.stringify(initialState));
     }
     const content = fs3.readFileSync(stateFile, "utf-8");
     const partial = JSON.parse(content);
     return {
-      ...partial.firstSetupRequired !== void 0 ? { firstSetupRequired: partial.firstSetupRequired } : {},
       autoContinue: { ...DEFAULT_HOOK_STATE.autoContinue, ...partial.autoContinue },
       validateCommit: { ...DEFAULT_HOOK_STATE.validateCommit, ...partial.validateCommit },
       denyList: { ...DEFAULT_HOOK_STATE.denyList, ...partial.denyList },
@@ -184,10 +191,16 @@ function createHookState(autoDir) {
     };
   }
   function write(state) {
+    if (!fs3.existsSync(autoDir)) {
+      return;
+    }
     fs3.writeFileSync(stateFile, `${JSON.stringify(state, null, 2)}
 `);
   }
   function update(updates) {
+    if (!fs3.existsSync(autoDir)) {
+      return { ...DEFAULT_HOOK_STATE };
+    }
     const current = read();
     const newState = {
       ...current,
@@ -218,6 +231,9 @@ function createHookState(autoDir) {
 
 // src/hooks/auto-continue.ts
 function handleStop(autoDir, input2) {
+  if (!(0, import_node_fs2.existsSync)(autoDir)) {
+    return { decision: "allow", reason: "auto-continue disabled" };
+  }
   const stateManager = createHookState(autoDir);
   const state = stateManager.read();
   const { mode, skipModes } = state.autoContinue;
@@ -279,9 +295,11 @@ function logPluginDiagnostics(hookName, paths) {
   if (isDebug) {
     console.error(message);
   }
-  const logsDir = path5.join(paths.autoDir, "logs");
-  fs4.mkdirSync(logsDir, { recursive: true });
-  fs4.appendFileSync(path5.join(logsDir, "plugin-debug.log"), message);
+  if (fs4.existsSync(paths.autoDir)) {
+    const logsDir = path5.join(paths.autoDir, "logs");
+    fs4.mkdirSync(logsDir, { recursive: true });
+    fs4.appendFileSync(path5.join(logsDir, "plugin-debug.log"), message);
+  }
 }
 
 // scripts/auto-continue.ts