@agentbrain/cli 1.3.0 → 1.3.2

package/README.md

@@ -10,6 +10,19 @@ npm install -g @agentbrain/cli
 
 ## Quick Start
 
+```bash
+# ONE-TIME SETUP: Complete automated setup
+cd /path/to/your/project
+agentbrain setup
+
+# That's it! AgentBrain now:
+# ✓ Generates context automatically on commits
+# ✓ Injects loading instructions into agent files
+# ✓ Keeps everything in sync with your codebase
+```
+
+### Manual Setup (Advanced)
+
 ```bash
 # Configure your API key
 agentbrain config
@@ -27,6 +40,48 @@ agentbrain handoff
 
 ## Commands
 
+### `agentbrain setup`
+
+**One-command automated setup** for AgentBrain in your repository.
+
+**Usage:**
+```bash
+agentbrain setup [options]
+```
+
+**Options:**
+- `--path <path>` - Repository path (default: current directory)
+- `--skip-hooks` - Skip git hooks installation
+- `--skip-agent-files` - Skip agent file injection
+
+**What it does:**
+1. Detects which agents you use (Claude Code, Cursor, Windsurf)
+2. Generates initial context documentation
+3. Injects context loading instructions into agent files
+4. Installs smart git hooks for automatic regeneration
+5. Sets up complete automation
+
+**Output:**
+- Creates `agentbrain/` directory with context docs
+- Updates `CLAUDE.md`, `.cursorrules`, and/or `.windsurfrules`
+- Installs `.git/hooks/post-commit` for smart auto-regeneration
+
+**Example:**
+```bash
+# Complete automated setup
+agentbrain setup
+
+# Setup without git hooks
+agentbrain setup --skip-hooks
+```
+
+**Cost:** ~$0.02-0.05 for initial generation (cached repeats are free)
+
+**Smart Git Hooks:**
+After setup, AgentBrain automatically regenerates context when you commit **source file changes**. It intelligently skips regeneration when only documentation or configuration files change, saving time and API costs.
+
+---
+
 ### `agentbrain init`
 
 Generate comprehensive context documentation for your repository.
@@ -87,8 +142,8 @@ agentbrain standards [options]
 
 **Output:**
 Creates agent-specific files:
-- `CLAUDE.md` - For Claude Code
-- `.cursor/rules` - For Cursor
+- `CLAUDE.md` - For Claude Code CLI
+- `.cursorrules` - For Cursor (also supports legacy `.cursor/rules`)
 - `.windsurfrules` - For Windsurf
 
 **Example:**
@@ -221,23 +276,29 @@ This stores the key securely at `~/.agentbrain/config.json` with 0600 permission
 
 ## Usage with AI Agents
 
-### Claude Code
+After running `agentbrain setup`, your agents automatically load context at every session start.
 
-Add to your workspace:
-```markdown
-<!-- In CLAUDE.md or prompt -->
-@agentbrain/context.md
-@agentbrain/dependency-map.md
-@agentbrain/patterns.md
-```
+### Claude Code CLI
+
+AgentBrain injects loading instructions into `CLAUDE.md`, which Claude Code CLI reads automatically from your project root. No manual action needed.
 
 ### Cursor
 
-Cursor automatically loads `.cursor/rules` generated by `agentbrain standards`.
+AgentBrain injects loading instructions into `.cursorrules` (or `.cursor/rules` for legacy setups), which Cursor reads automatically. No manual action needed.
 
 ### Windsurf
 
-Windsurf automatically loads `.windsurfrules` generated by `agentbrain standards`.
+AgentBrain injects loading instructions into `.windsurfrules`, which Windsurf reads automatically. No manual action needed.
+
+### Manual Loading (Advanced)
+
+If not using `agentbrain setup`, you can manually reference context files:
+```markdown
+<!-- In agent prompt or rules file -->
+@agentbrain/context.md
+@agentbrain/dependency-map.md
+@agentbrain/patterns.md
+```
 
 ## Cost Estimates
 
@@ -255,6 +316,26 @@ All costs are approximate (as of January 2025):
 
 ## Workflow Example
 
+### Recommended: Automated Setup
+
+```bash
+# 1. One-time setup (do once per repo)
+cd /path/to/project
+agentbrain setup
+
+# 2. Start coding - context auto-updates on commits!
+# ... make changes ...
+git commit -m "Add feature"
+# → AgentBrain automatically regenerates context (if source files changed)
+
+# 3. Generate handoff when needed
+agentbrain handoff --goal "Completed authentication feature"
+
+# That's it! Everything else is automatic.
+```
+
+### Manual Setup (Advanced)
+
 ```bash
 # 1. Initial setup
 cd /path/to/project
@@ -271,7 +352,7 @@ agentbrain standards
 # ... make changes ...
 agentbrain handoff --goal "Add authentication feature"
 
-# 5. Regenerate context after major changes
+# 5. Manually regenerate context after changes
 agentbrain init  # Only costs money if git hash changed
 ```
 

package/dist/index.js

@@ -10,7 +10,7 @@ const program = new Command();
 program
     .name('agentbrain')
     .description('Generate smart context docs for coding agents')
-    .version('1.3.0');
+    .version('1.3.2');
 // Add commands
 program.addCommand(createSetupCommand());
 program.addCommand(createInitCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentbrain/cli",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "CLI for AgentBrain - generate smart context documentation for coding agents",
   "type": "module",
   "main": "./dist/index.js",