@get-blu/blu-code 1.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Kujtim Hoxha
+Copyright (c) 2026 Garv Agnihotri (Blu)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,296 @@
+# Blu
+
+>Blu is a Go-powered terminal UI that brings AI-assisted coding directly into your command line. It connects to leading models and gives them tools to read, analyze, and modify your codebase from an elegant TUI built with Bubble Tea.
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Go Version](https://img.shields.io/badge/go-1.21+-00ADD8.svg)](https://go.dev/)
+
+## Overview
+
+Blu is a Go-powered terminal UI that transforms your command line into an intelligent development environment. It connects to leading AI models and provides them with powerful tools to read, analyze, and modify your codebase - all from an elegant TUI built with [Bubble Tea](https://github.com/charmbracelet/bubbletea).
+
+**Key capabilities:**
+- Chat with AI models that can see and edit your files
+- Execute bash commands through AI suggestions
+- Apply complex code refactors automatically
+- Get real-time LSP diagnostics and code intelligence
+- Manage multiple conversation sessions with full context
+- Use Model Context Protocol (MCP) servers for extensibility
+
+## Quick Start
+
+### Installation
+
+**Via install script:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/Get-Blu/blu-code/main/install | bash
+```
+
+**From source:**
+```bash
+git clone https://github.com/Get-Blu/blu-code.git
+cd blu-code
+go build -o blu
+blu
+```
+
+### Setup
+
+1. Set your API key(s):
+```bash
+export ANTHROPIC_API_KEY="your-key-here"
+# or OPENAI_API_KEY, GEMINI_API_KEY
+```
+
+2. Create a `.blu.json` config file (optional):
+```json
+{
+  "agents": {
+    "coder": {
+      "model": "claude-sonnet-4-5-20250929",
+      "maxTokens": 8192
+    }
+  },
+  "autoCompact": true
+}
+```
+
+3. Launch Blu:
+```bash
+blu
+```
+
+## Features
+
+### Multi-Model Support
+Switch between Claude, GPT, Gemini, or any OpenAI-compatible endpoint. Use different models for different tasks within the same session.
+
+### Intelligent File Operations
+- **Glob patterns**: Find files matching complex patterns
+- **Smart grep**: Search across your codebase with regex
+- **Atomic edits**: Apply precise diffs and patches
+- **Batch operations**: Modify multiple files in one go
+
+### Development Tools
+- **LSP Integration**: Real-time diagnostics and code intelligence via Language Server Protocol
+- **Command execution**: Run bash commands directly from chat
+- **MCP Support**: Extend with Model Context Protocol servers
+- **Version control aware**: Understands your git context
+
+### Productivity Features
+- **Session management**: Switch between multiple conversations (`Ctrl+S`)
+- **Custom commands**: Create reusable prompt templates (`Ctrl+K`)
+- **Auto-compaction**: Intelligent context window management
+- **SQLite persistence**: Full local history storage
+- **Interactive sidebar**: Visualize file changes in real-time
+
+## Usage
+
+### Basic Workflow
+
+1. **Start a conversation**: Launch `blu` and ask a question
+2. **Let AI explore**: Blu can read files, search your codebase, and understand context
+3. **Review changes**: See proposed file modifications in the sidebar
+4. **Apply or reject**: Accept changes you want, skip the rest
+
+## Keyboard Shortcuts
+
+### Global Shortcuts
+
+| Shortcut | Action                                                  |
+| -------- | ------------------------------------------------------- |
+| `Ctrl+C` | Quit application                                        |
+| `Ctrl+?` | Toggle help dialog                                      |
+| `?`      | Toggle help dialog (when not in editing mode)           |
+| `Ctrl+L` | View logs                                               |
+| `Ctrl+S` | Switch session                                          |
+| `Ctrl+K` | Command dialog                                          |
+| `Ctrl+O` | Toggle model selection dialog                           |
+| `Ctrl+P` | Toggle provider selection (API key configuration)      |
+| `Esc`    | Close current overlay/dialog or return to previous mode |
+
+### Chat Page Shortcuts
+
+| Shortcut | Action                                  |
+| -------- | --------------------------------------- |
+| `Ctrl+N` | Create new session                      |
+| `Ctrl+X` | Cancel current operation/generation     |
+| `i`      | Focus editor (when not in writing mode) |
+| `Esc`    | Exit writing mode and focus messages    |
+
+### Editor Shortcuts
+
+| Shortcut            | Action                                    |
+| ------------------- | ----------------------------------------- |
+| `Ctrl+S`            | Send message (when editor is focused)     |
+| `Enter` or `Ctrl+S` | Send message (when editor is not focused) |
+| `Ctrl+E`            | Open external editor                      |
+| `Esc`               | Blur editor and focus messages            |
+
+### Session Dialog Shortcuts
+
+| Shortcut   | Action           |
+| ---------- | ---------------- |
+| `↑` or `k` | Previous session |
+| `↓` or `j` | Next session     |
+| `Enter`    | Select session   |
+| `Esc`      | Close dialog     |
+
+### Model Dialog Shortcuts
+
+| Shortcut   | Action            |
+| ---------- | ----------------- |
+| `↑` or `k` | Move up           |
+| `↓` or `j` | Move down         |
+| `←` or `h` | Previous provider (within model dialog) |
+| `→` or `l` | Next provider (within model dialog)     |
+| `Esc`      | Close dialog                            |
+
+### Provider & API Key Dialog Shortcuts
+
+| Shortcut | Action               |
+| -------- | -------------------- |
+| `↑` / `↓` | Move up/down         |
+| `Enter`  | Select provider      |
+| `Esc`    | Close dialog         |
+| `Enter`  | Save API key (input) |
+
+### Permission Dialog Shortcuts
+
+| Shortcut                | Action                       |
+| ----------------------- | ---------------------------- |
+| `←` or `left`           | Switch options left          |
+| `→` or `right` or `tab` | Switch options right         |
+| `Enter` or `space`      | Confirm selection            |
+| `a`                     | Allow permission             |
+| `A`                     | Allow permission for session |
+| `d`                     | Deny permission              |
+
+### Logs Page Shortcuts
+
+| Shortcut           | Action              |
+| ------------------ | ------------------- |
+| `Backspace` or `q` | Return to chat page |
+
+## Configuration
+
+Place `.blu.json` in your home directory (`~/.blu.json`) or project root:
+
+```json
+{
+  "agents": {
+    "coder": {
+      "model": "claude-3.7-sonnet",
+      "maxTokens": 8192,
+      "temperature": 0.7
+    },
+    "summarizer": {
+      "model": "gpt-4o-mini",
+      "maxTokens": 2048
+    }
+  },
+  "autoCompact": true,
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed"]
+    }
+  }
+}
+```
+
+### 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)
+
+**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)
+
+**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)
+
+**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)
+
+### Environment Variables
+
+| Variable | Purpose |
+|----------|---------|
+| `ANTHROPIC_API_KEY` | Claude API access |
+| `OPENAI_API_KEY` | GPT-4 API access |
+| `GEMINI_API_KEY` | Gemini API access |
+| `BLU_DEBUG=true` | Enable debug logging |
+| `BLU_CONFIG=/path/to/.blu.json` | Custom config location |
+
+## Troubleshooting
+
+**Blu won't start**
+- Check your API keys are set
+- Verify Go 1.21+ is installed
+- Try `blu --debug` for detailed logs
+
+**AI can't see my files**
+- Ensure you're running Blu from your project directory
+- Check file permissions
+- Verify paths in error messages
+
+**Context window errors**
+- Enable `autoCompact` in config
+- Start a new session for fresh context
+- Use more concise prompts
+
+## Building from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/Get-Blu/blu-code.git
+cd blu-code
+
+# Install dependencies
+go mod download
+
+# Build
+go build -o blu
+
+# Run tests
+go test ./...
+
+# Install globally
+sudo mv blu /usr/local/bin/
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit issues or pull requests.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## Credits
+
+Blu builds on the excellent work of:
+
+- **[OpenCode](https://github.com/opencode-ai/opencode)** - The foundation Blu is built upon
+- **[@adamdottv](https://github.com/adamdottv)** - Original OpenCode design and architecture
+- **[@isaacphi](https://github.com/isaacphi)** - LSP integration via `mcp-language-server`
+- **[Bubble Tea](https://github.com/charmbracelet/bubbletea)** - Excellent TUI framework
+
+## License
+
+Distributed under the **MIT License**. See `LICENSE` for more information.
+
+**Created by [Garv Agnihotri](https://github.com/Get-Blu)**

package/bin/cli.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const os = process.platform;
+
+// Determine the binary name based on the OS
+const binaryName = os === 'win32' ? 'blu.exe' : 'blu';
+const binaryPath = path.join(__dirname, binaryName);
+
+// Construct the arguments
+const args = process.argv.slice(2);
+
+// Spawn the binary
+const child = spawn(binaryPath, args, { stdio: 'inherit' });
+
+child.on('exit', (code) => {
+    process.exit(code);
+});
+
+child.on('error', (err) => {
+    console.error(`Failed to start subprocess: ${err}`);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@get-blu/blu-code",
+  "version": "1.0.1",
+  "description": "Terminal-based AI assistant for software development",
+  "bin": {
+    "blu": "./bin/cli.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install-npm.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Get-Blu/blu-code.git"
+  },
+  "author": "Get-Blu",
+  "license": "MIT",
+  "engines": {
+    "node": ">=12.0.0"
+  },
+  "files": [
+    "bin",
+    "scripts/install-npm.js",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/scripts/install-npm.js

@@ -0,0 +1,86 @@
+const fs = require('fs');
+const https = require('https');
+const path = require('path');
+const os = require('os');
+const { version } = require('../package.json');
+
+const platform = process.platform;
+const arch = process.arch;
+
+// Map OS
+let goos = '';
+let ext = '';
+if (platform === 'win32') {
+    goos = 'windows';
+    ext = '.exe';
+} else if (platform === 'darwin') {
+    goos = 'darwin';
+} else if (platform === 'linux') {
+    goos = 'linux';
+} else {
+    console.error(`Unsupported OS: ${platform}`);
+    process.exit(1);
+}
+
+// Map Architecture
+let goarch = '';
+if (arch === 'x64') {
+    goarch = 'amd64';
+} else if (arch === 'arm64') {
+    goarch = 'arm64';
+} else {
+    console.error(`Unsupported architecture: ${arch}`);
+    process.exit(1);
+}
+
+// Construct URL
+// Artifact names from GitHub Release: blu-code-linux-amd64, blu-code-windows-amd64.exe
+const binName = `blu-code-${goos}-${goarch}${ext}`;
+const url = `https://github.com/Get-Blu/blu-code/releases/download/v${version}/${binName}`;
+
+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);
+
+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);
+            }
+            response.pipe(file);
+            file.on('finish', () => {
+                file.close();
+                console.log(`Download complete: ${destFile}`);
+                if (platform !== 'win32') {
+                    fs.chmodSync(destFile, 0o755);
+                }
+            });
+        });
+    } else if (response.statusCode !== 200) {
+        console.error(`Failed to download binary: ${response.statusCode}`);
+        process.exit(1);
+    } else {
+        response.pipe(file);
+        file.on('finish', () => {
+            file.close();
+            console.log(`Download complete: ${destFile}`);
+            if (platform !== 'win32') {
+                fs.chmodSync(destFile, 0o755);
+            }
+        });
+    }
+}).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);
+});