@agentbrain/cli 1.1.1 → 1.2.0

package/README.md

@@ -163,9 +163,13 @@ agentbrain config --show
 
 Configuration stored at `~/.agentbrain/config.json` with secure permissions.
 
-## Environment Variables
+---
+
+## API Key Configuration
+
+AgentBrain supports multiple ways to provide your API key. They are checked in this priority order:
 
-Instead of storing keys, you can use environment variables:
+### 1. Environment Variables (Highest Priority)
 
 ```bash
 # Anthropic
@@ -175,7 +179,45 @@ export ANTHROPIC_API_KEY="sk-ant-..."
 export OPENAI_API_KEY="sk-..."
 ```
 
-Environment variables take priority over stored config.
+### 2. `.env` Files
+
+Create a `.env` or `.env.local` file in your project:
+
+```bash
+# In your project directory
+cat > .env <<EOF
+OPENAI_API_KEY=sk-...
+EOF
+```
+
+AgentBrain will automatically load API keys from:
+- `.env.local` in current directory
+- `.env` in current directory
+- `.env.local` in git repository root
+- `.env` in git repository root
+
+**Note:** `.env` files are loaded automatically - no need to export or source them!
+
+### 3. Stored Configuration (Lowest Priority)
+
+Use the `agentbrain config` command to store your key persistently:
+
+```bash
+agentbrain config
+```
+
+This stores the key securely at `~/.agentbrain/config.json` with 0600 permissions.
+
+---
+
+## Summary: API Key Priority
+
+1. ✅ Environment variables (`ANTHROPIC_API_KEY` or `OPENAI_API_KEY`)
+2. ✅ `.env.local` in current directory
+3. ✅ `.env` in current directory
+4. ✅ `.env.local` in git root
+5. ✅ `.env` in git root
+6. ✅ `~/.agentbrain/config.json`
 
 ## Usage with AI Agents
 

package/dist/index.js

@@ -9,7 +9,7 @@ const program = new Command();
 program
     .name('agentbrain')
     .description('Generate smart context docs for coding agents')
-    .version('1.1.1');
+    .version('1.2.0');
 // Add commands
 program.addCommand(createInitCommand());
 program.addCommand(createStandardsCommand());

package/package.json

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