@get-blu/blu-code 1.0.1 → 1.1.0

package/README.md

@@ -21,7 +21,12 @@ Blu is a Go-powered terminal UI that transforms your command line into an intell
 
 ### Installation
 
-**Via install script:**
+**Via npm (recommended):**
+```bash
+npm install -g @get-blu/blu-code
+```
+
+**Via raw script:**
 ```bash
 curl -fsSL https://raw.githubusercontent.com/Get-Blu/blu-code/main/install | bash
 ```
@@ -47,7 +52,7 @@ export ANTHROPIC_API_KEY="your-key-here"
 {
   "agents": {
     "coder": {
-      "model": "claude-sonnet-4-5-20250929",
+      "model": "claude-3.7-sonnet",
       "maxTokens": 8192
     }
   },
@@ -93,6 +98,27 @@ Switch between Claude, GPT, Gemini, or any OpenAI-compatible endpoint. Use diffe
 3. **Review changes**: See proposed file modifications in the sidebar
 4. **Apply or reject**: Accept changes you want, skip the rest
 
+## Documentation
+
+Comprehensive documentation is available in the `docs/` directory:
+
+- [Introduction](docs/introduction.md)
+- [Getting Started](docs/getting-started.md)
+- [Configuration](docs/configuration.md)
+- [Key Bindings](docs/key-bindings.md)
+- [Architecture](docs/architecture/overview.md)
+
+### Detailed Features
+- [AI Chat](docs/features/ai-chat.md)
+- [File Operations](docs/features/file-operations.md)
+- [LSP Intelligence](docs/features/lsp-and-intelligence.md)
+- [MCP Servers](docs/features/mcp-servers.md)
+- [Session Management](docs/features/session-management.md)
+
+### Guides
+- [Best Practices](docs/guides/best-practices.md)
+- [Troubleshooting](docs/guides/troubleshooting.md)
+
 ## Keyboard Shortcuts
 
 ### Global Shortcuts
@@ -202,26 +228,23 @@ Place `.blu.json` in your home directory (`~/.blu.json`) or project root:
 ### Supported Models
 
 **Anthropic (Claude):**
-- `claude-4.6-opus` - Claude 4.6 Opus (flagship capability)
-- `claude-3.7-sonnet` - Claude 3.7 Sonnet (recommended for coding)
+- `claude-3.7-sonnet` - Recommended for coding (supports reasoning)
+- `claude-3.5-sonnet` - Fast and highly capable
+- `claude-4.6-opus` - Next-gen flagship capability
 
 **OpenAI:**
-- `gpt-5.3-codex` - GPT-5.3 Codex (latest agentic flagship)
-- `gpt-5.2` - GPT-5.2 (multimodal, fast)
-- `o3-ultra` - O3 Ultra (advanced reasoning)
+- `o3-ultra` - Latest reasoning flagship
+- `gpt-5.3-codex` - Specialized for agentic coding
+- `gpt-4o` - Balanced speed and intelligence
 
 **Google:**
-- `gemini-3-deep-think` - Gemini 3 Deep Think (advanced scientific/engineering)
-- `gemini-3.0-pro` - Gemini 3.0 Pro (multimodal reasoning)
-- `gemini-2.0-flash` - Gemini 2.0 Flash (high speed intelligence)
+- `gemini-3-deep-think` - Advanced reasoning and engineering
+- `gemini-2.0-flash` - High-speed intelligence
+- `gemini-1.5-pro` - Large context window
 
 **DeepSeek:**
-- `deepseek-v3.2` - DeepSeek V3.2
-- `deepseek-r1` - DeepSeek R1 (reasoning model)
-
-**xAI:**
-- `grok-4.1` - Grok 4.1
-- `grok-4.20` - Grok 4.20 (Enterprise)
+- `deepseek-v3` - High performance open-weights model
+- `deepseek-r1` - Reasoning focused model
 
 ### Environment Variables
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@get-blu/blu-code",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Terminal-based AI assistant for software development",
   "bin": {
     "blu": "./bin/cli.js"
@@ -23,4 +23,4 @@
     "README.md",
     "LICENSE"
   ]
-}
+}

package/scripts/install-npm.js

@@ -40,47 +40,55 @@ const url = `https://github.com/Get-Blu/blu-code/releases/download/v${version}/$
 
 console.log(`Downloading ${url} ...`);
 
-const destDir = path.join(__dirname, '..', 'bin');
-if (!fs.existsSync(destDir)) {
-    fs.mkdirSync(destDir, { recursive: true });
-}
-
-const destFile = path.join(destDir, `blu${ext}`);
-
-const file = fs.createWriteStream(destFile);
+const download = (url, dest) => {
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(dest);
+        https.get(url, (response) => {
+            if (response.statusCode === 302 || response.statusCode === 301) {
+                file.close();
+                fs.unlinkSync(dest); // Clean up partial file before redirect
+                return resolve(download(response.headers.location, dest));
+            }
 
-https.get(url, (response) => {
-    if (response.statusCode === 302 || response.statusCode === 301) {
-        // Handle redirect
-        https.get(response.headers.location, (response) => {
             if (response.statusCode !== 200) {
-                console.error(`Failed to download binary: ${response.statusCode}`);
-                process.exit(1);
+                file.close();
+                fs.unlinkSync(dest);
+                return reject(new Error(`Failed to download binary: HTTP ${response.statusCode}`));
             }
+
             response.pipe(file);
             file.on('finish', () => {
                 file.close();
-                console.log(`Download complete: ${destFile}`);
-                if (platform !== 'win32') {
-                    fs.chmodSync(destFile, 0o755);
+                const stats = fs.statSync(dest);
+                if (stats.size === 0) {
+                    fs.unlinkSync(dest);
+                    return reject(new Error('Downloaded binary is empty'));
                 }
+                resolve();
             });
-        });
-    } else if (response.statusCode !== 200) {
-        console.error(`Failed to download binary: ${response.statusCode}`);
-        process.exit(1);
-    } else {
-        response.pipe(file);
-        file.on('finish', () => {
+        }).on('error', (err) => {
             file.close();
-            console.log(`Download complete: ${destFile}`);
-            if (platform !== 'win32') {
-                fs.chmodSync(destFile, 0o755);
-            }
+            if (fs.existsSync(dest)) fs.unlinkSync(dest);
+            reject(err);
         });
-    }
-}).on('error', (err) => {
-    fs.unlink(destFile, () => { }); // Delete the file async. (But we don't check result)
-    console.error(`Error downloading binary: ${err.message}`);
-    process.exit(1);
-});
+    });
+};
+
+const destDir = path.join(__dirname, '..', 'bin');
+if (!fs.existsSync(destDir)) {
+    fs.mkdirSync(destDir, { recursive: true });
+}
+
+const destFile = path.join(destDir, `blu${ext}`);
+
+download(url, destFile)
+    .then(() => {
+        console.log(`Download complete: ${destFile}`);
+        if (platform !== 'win32') {
+            fs.chmodSync(destFile, 0o755);
+        }
+    })
+    .catch((err) => {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    });