@blackbox_ai/blackbox-cli 0.0.7 → 0.8.1

package/README.md

@@ -4,50 +4,9 @@
 
 ![Blackbox Code Screenshot](./docs/assets/blackbox-screenshot.png)
 
-[![npm version](https://img.shields.io/npm/v/@blackbox_ai/blackbox-cli.svg)](https://www.npmjs.com/package/@blackbox_ai/blackbox-cli)
-[![License](https://img.shields.io/github/license/llmcod/blackbox-cli.svg)](./LICENSE)
-[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org/)
-[![Downloads](https://img.shields.io/npm/dm/@blackbox_ai/blackbox-cli.svg)](https://www.npmjs.com/package/@blackbox_ai/blackbox-cli)
 
-**AI-powered command-line workflow tool for developers**
-
-[Installation](#installation) • [Quick Start](#quick-start) • [Features](#key-features) • [Documentation](./docs/) • [Contributing](./CONTRIBUTING.md)
-
-</div>
-
-<div align="center">
-  
-  <a href="https://blackbox_ai.github.io/blackbox-cli-docs/de/">Deutsch</a> | 
-  <a href="https://blackbox_ai.github.io/blackbox-cli-docs/fr">français</a> | 
-  <a href="https://blackbox_ai.github.io/blackbox-cli-docs/ja/">日本語</a> | 
-  <a href="https://blackbox_ai.github.io/blackbox-cli-docs/ru">Русский</a> | 
-  <a href="https://blackbox_ai.github.io/blackbox-cli-docs/zh/">中文</a>
-  
 </div>
 
-Blackbox Code is a powerful command-line AI workflow tool adapted from [**Gemini CLI**](https://github.com/google-gemini/gemini-cli) ([details](./README.gemini.md)), specifically optimized for [Blackbox3-Coder](https://github.com/llmcod/Blackbox3-Coder) models. It enhances your development workflow with advanced code understanding, automated tasks, and intelligent assistance.
-
-## 💡 Free Options Available
-
-Get started with Blackbox Code at no cost using any of these free options:
-
-### 🔥 Blackbox OAuth (Recommended)
-
-- **2,000 requests per day** with no token limits
-- **60 requests per minute** rate limit
-- Simply run `blackbox` and authenticate with your blackbox.ai account
-- Automatic credential management and refresh
-- Use `/auth` command to switch to Blackbox OAuth if you have initialized with OpenAI compatible mode
-
-### 🌏 Regional Free Tiers
-
-- **Mainland China**: ModelScope offers **2,000 free API calls per day**
-- **International**: OpenRouter provides **up to 1,000 free API calls per day** worldwide
-
-For detailed setup instructions, see [Authorization](#authorization).
-
-> [!WARNING]
-> **Token Usage Notice**: Blackbox Code may issue multiple API calls per cycle, resulting in higher token usage (similar to Claude Code). We're actively optimizing API efficiency.
 
 ## Key Features
 
@@ -66,12 +25,6 @@ Ensure you have [Node.js version 20](https://nodejs.org/en/download) or higher i
 curl -qL https://www.npmjs.com/install.sh | sh
 ```
 
-### Install from npm
-
-```bash
-npm install -g @blackbox_ai/blackbox-cli@latest
-blackbox --version
-```
 
 ### Install from source
 
@@ -120,7 +73,7 @@ Create or edit `.blackboxcli/settings.json` in your home directory:
 - **`/clear`** - Clear all conversation history and start fresh
 - **`/stats`** - Check current token usage and limits
 
-> 📝 **Note**: Session token limit applies to a single conversation, not cumulative API calls.
+> **Note**: Session token limit applies to a single conversation, not cumulative API calls.
 
 ### Vision Model Configuration
 
@@ -145,20 +98,6 @@ If you don't want to see the interactive dialog each time, configure the default
 - **`"persist"`** - Continue with current model (no switching)
 - **Not set** - Show interactive dialog each time (default)
 
-#### Command Line Override
-
-You can also set the behavior via command line:
-
-```bash
-# Switch once per query
-blackbox --vlm-switch-mode once
-
-# Switch for entire session
-blackbox --vlm-switch-mode session
-
-# Never switch automatically
-blackbox --vlm-switch-mode persist
-```
 
 #### Disable Vision Models (Optional)
 
@@ -172,13 +111,13 @@ To completely disable vision model support, add to your `.blackboxcli/settings.j
 }
 ```
 
-> 💡 **Tip**: In YOLO mode (`--yolo`), vision switching happens automatically without prompts when images are detected.
+> **Tip**: In YOLO mode (`--yolo`), vision switching happens automatically without prompts when images are detected.
 
 ### Authorization
 
 Choose your preferred authentication method based on your needs:
 
-#### 1. Blackbox OAuth (🚀 Recommended - Start in 30 seconds)
+#### 1. Blackbox OAuth (Recommended - Start in 30 seconds)
 
 The easiest way to get started - completely free with generous quotas:
 
@@ -187,98 +126,10 @@ The easiest way to get started - completely free with generous quotas:
 blackbox
 ```
 
-**What happens:**
-
-1. **Instant Setup**: CLI opens your browser automatically
-2. **One-Click Login**: Authenticate with your blackbox.ai account
-3. **Automatic Management**: Credentials cached locally for future use
-4. **No Configuration**: Zero setup required - just start coding!
-
-**Free Tier Benefits:**
-
-- ✅ **2,000 requests/day** (no token counting needed)
-- ✅ **60 requests/minute** rate limit
-- ✅ **Automatic credential refresh**
-- ✅ **Zero cost** for individual users
-- ℹ️ **Note**: Model fallback may occur to maintain service quality
-
-#### 2. OpenAI-Compatible API
-
-Use API keys for OpenAI or other compatible providers:
-
-**Configuration Methods:**
-
-1. **Environment Variables**
-
-   ```bash
-   export OPENAI_API_KEY="your_api_key_here"
-   export OPENAI_BASE_URL="your_api_endpoint"
-   export OPENAI_MODEL="your_model_choice"
-   ```
-
-2. **Project `.env` File**
-   Create a `.env` file in your project root:
-   ```env
-   OPENAI_API_KEY=your_api_key_here
-   OPENAI_BASE_URL=your_api_endpoint
-   OPENAI_MODEL=your_model_choice
-   ```
-
-**API Provider Options**
-
-> ⚠️ **Regional Notice:**
->
-> - **Mainland China**: Use Alibaba Cloud Bailian or ModelScope
-> - **International**: Use Alibaba Cloud ModelStudio or OpenRouter
-
-<details>
-<summary><b>🇨🇳 For Users in Mainland China</b></summary>
-
-**Option 1: Alibaba Cloud Bailian** ([Apply for API Key](https://bailian.console.aliyun.com/))
-
-```bash
-export OPENAI_API_KEY="your_api_key_here"
-export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
-export OPENAI_MODEL="blackbox3-coder-plus"
-```
-
-**Option 2: ModelScope (Free Tier)** ([Apply for API Key](https://modelscope.cn/docs/model-service/API-Inference/intro))
-
-- ✅ **2,000 free API calls per day**
-- ⚠️ Connect your Aliyun account to avoid authentication errors
-
-```bash
-export OPENAI_API_KEY="your_api_key_here"
-export OPENAI_BASE_URL="https://api-inference.modelscope.cn/v1"
-export OPENAI_MODEL="Blackbox/Blackbox3-Coder-480B-A35B-Instruct"
-```
-
-</details>
-
-<details>
-<summary><b>🌍 For International Users</b></summary>
-
-**Option 1: Alibaba Cloud ModelStudio** ([Apply for API Key](https://modelstudio.console.alibabacloud.com/))
-
-```bash
-export OPENAI_API_KEY="your_api_key_here"
-export OPENAI_BASE_URL="https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
-export OPENAI_MODEL="blackbox3-coder-plus"
-```
-
-**Option 2: OpenRouter (Free Tier Available)** ([Apply for API Key](https://openrouter.ai/))
-
-```bash
-export OPENAI_API_KEY="your_api_key_here"
-export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
-export OPENAI_MODEL="blackbox/blackbox3-coder:free"
-```
-
-</details>
 
 ## Usage Examples
 
-### 🔍 Explore Codebases
+### Explore Codebases
 
 ```bash
 cd your-project/
@@ -290,7 +141,7 @@ blackbox
 > Find all API endpoints and their authentication methods
 ```
 
-### 💻 Code Development
+### Code Development
 
 ```bash
 # Refactoring
@@ -304,7 +155,7 @@ blackbox
 > Add error handling to all database operations
 ```
 
-### 🔄 Automate Workflows
+### Automate Workflows
 
 ```bash
 # Git automation
@@ -318,7 +169,7 @@ blackbox
 > Find and remove all console.log statements
 ```
 
-### 🐛 Debugging & Analysis
+### Debugging & Analysis
 
 ```bash
 # Performance analysis
@@ -332,7 +183,7 @@ blackbox
 
 ## Popular Tasks
 
-### 📚 Understand New Codebases
+### Understand New Codebases
 
 ```text
 > What are the core business logic components?
@@ -342,7 +193,7 @@ blackbox
 > Generate a dependency graph for this module
 ```
 
-### 🔨 Code Refactoring & Optimization
+### Code Refactoring & Optimization
 
 ```text
 > What parts of this module can be optimized?
@@ -352,7 +203,7 @@ blackbox
 > Implement caching for expensive operations
 ```
 
-### 📝 Documentation & Testing
+### Documentation & Testing
 
 ```text
 > Generate comprehensive JSDoc comments for all public APIs
@@ -362,7 +213,7 @@ blackbox
 > Generate a README for this module
 ```
 
-### 🚀 Development Acceleration
+### Development Acceleration
 
 ```text
 > Set up a new Express server with authentication
@@ -388,25 +239,6 @@ blackbox
 - `Ctrl+D` - Exit (on empty line)
 - `Up/Down` - Navigate command history
 
-## Benchmark Results
-
-### Terminal-Bench Performance
-
-| Agent     | Model              | Accuracy |
-| --------- | ------------------ | -------- |
-| Blackbox Code | Blackbox3-Coder-480A35 | 37.5%    |
-| Blackbox Code | Blackbox3-Coder-30BA3B | 31.3%    |
-
-## Development & Contributing
-
-See [CONTRIBUTING.md](./CONTRIBUTING.md) to learn how to contribute to the project.
-
-For detailed authentication setup, see the [authentication guide](./docs/cli/authentication.md).
-
-## Troubleshooting
-
-If you encounter issues, check the [troubleshooting guide](docs/troubleshooting.md).
-
 ## Acknowledgments
 
 This project is based on [Google Gemini CLI](https://github.com/google-gemini/gemini-cli). We acknowledge and appreciate the excellent work of the Gemini CLI team. Our main contribution focuses on parser-level adaptations to better support BlackboxAI models.
@@ -414,7 +246,3 @@ This project is based on [Google Gemini CLI](https://github.com/google-gemini/ge
 ## License
 
 [LICENSE](./LICENSE)
-
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=llmcod/blackbox-cli&type=Date)](https://www.star-history.com/#llmcod/blackbox-cli&Date)

package/dist/index.js

@@ -7,8 +7,15 @@
 import './src/gemini.js';
 import { main } from './src/gemini.js';
 import { FatalError } from '@blackbox_ai/blackbox-cli-core';
+import { preLaunchUpdateCheck } from './src/utils/preLaunchUpdateCheck.js';
 // --- Global Entry Point ---
-main().catch((error) => {
+// First, check for updates before starting the CLI
+preLaunchUpdateCheck()
+    .then(() => {
+    // After update check (and potential update), start the main CLI
+    return main();
+})
+    .catch((error) => {
     if (error instanceof FatalError) {
         let errorMessage = error.message;
         if (!process.env['NO_COLOR']) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,iBAAiB,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,6BAA6B;AAC7B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,IAAI,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,YAAY,GAAG,WAAW,YAAY,SAAS,CAAC;QAClD,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACxD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,iBAAiB,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,6BAA6B;AAC7B,mDAAmD;AACnD,oBAAoB,EAAE;KACnB,IAAI,CAAC,GAAG,EAAE;IACT,gEAAgE;IAChE,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACf,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,IAAI,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,YAAY,GAAG,WAAW,YAAY,SAAS,CAAC;QAClD,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACxD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@blackbox_ai/blackbox-cli",
-    "version": "0.0.7",
+    "version": "0.8.1",
     "description": "Blackbox Code",
     "repository": {
         "type": "git",
@@ -28,14 +28,20 @@
         "sandboxImageUri": "ghcr.io/blackbox_ai/blackbox-cli:0.0.1"
     },
     "dependencies": {
-        "@blackbox_ai/blackbox-cli-core": "0.0.7",
-        "@google/genai": "1.9.0",
+        "@agentclientprotocol/sdk": "^0.11.0",
+        "@blackbox_ai/blackbox-cli-core": "0.8.1",
+        "@ffmpeg-installer/ffmpeg": "^1.1.0",
+        "@google/genai": "^1.26.0",
         "@iarna/toml": "^2.2.5",
         "@modelcontextprotocol/sdk": "^1.15.1",
+        "@types/fluent-ffmpeg": "^2.1.27",
         "@types/update-notifier": "^6.0.8",
+        "@types/ws": "^8.18.1",
         "command-exists": "^1.2.9",
         "diff": "^7.0.0",
         "dotenv": "^17.1.0",
+        "extract-zip": "^2.0.1",
+        "fluent-ffmpeg": "^2.1.3",
         "fzf": "^0.5.2",
         "glob": "^10.4.1",
         "highlight.js": "^11.11.1",
@@ -55,8 +61,10 @@
         "string-width": "^7.1.0",
         "strip-ansi": "^7.1.0",
         "strip-json-comments": "^3.1.1",
+        "tar": "^7.4.3",
         "undici": "^7.10.0",
         "update-notifier": "^7.3.1",
+        "ws": "^8.18.3",
         "yargs": "^17.7.2",
         "zod": "^3.23.8"
     },
@@ -74,7 +82,9 @@
         "@types/react-dom": "^19.1.6",
         "@types/semver": "^7.7.0",
         "@types/shell-quote": "^1.7.5",
+        "@types/tar": "^6.1.13",
         "@types/yargs": "^17.0.32",
+        "google-auth-library": "^10.4.1",
         "ink-testing-library": "^4.0.0",
         "jsdom": "^26.1.0",
         "pretty-format": "^30.0.2",

package/dist/src/built-in-extensions/conductor/README.md

@@ -0,0 +1,242 @@
+# Conductor Extension for Blackbox CLI
+
+The Conductor extension enables Context-Driven Development (CDD) - a structured approach to software development that emphasizes clear specifications, systematic planning, and rigorous execution tracking.
+
+## Overview
+
+Conductor provides a spec-driven workflow that guides you through:
+1. **Context** - Understanding the problem and requirements
+2. **Spec & Plan** - Creating detailed specifications and implementation plans
+3. **Implement** - Following the plan with strict adherence to workflow
+
+## Installation
+
+```bash
+blackbox extensions install ./path/to/conductor
+```
+
+Or copy this example to your extensions directory:
+```bash
+cp -r packages/cli/src/commands/extensions/examples/conductor ~/.blackbox/extensions/
+```
+
+## Commands
+
+### `/conductor:setup`
+Initialize a new project with Conductor workflow files.
+
+**Usage:**
+```
+/conductor:setup
+```
+
+**What it creates:**
+- `plan.md` - Project plan with phases and tasks
+- `tech-stack.md` - Technology decisions and architecture
+- `product.md` - Product specification and requirements
+- `product-guidelines.md` - Design and development guidelines
+- `workflow.md` - Development workflow and processes
+- `code_styleguides/` - Language-specific style guides
+- `.blackboxignore` - Files to exclude from Blackbox context
+
+### `/conductor:newTrack`
+Create a new development track (feature/bug fix) with planning.
+
+**Usage:**
+```
+/conductor:newTrack
+```
+
+**What it does:**
+- Analyzes current project state
+- Creates detailed implementation plan
+- Sets up tracking structure
+- Guides through specification process
+
+### `/conductor:implement`
+Work on the current track following Conductor workflow.
+
+**Usage:**
+```
+/conductor:implement
+```
+
+**What it does:**
+- Enforces Test-Driven Development (TDD)
+- Tracks task progress in `plan.md`
+- Manages git commits with detailed notes
+- Handles phase completion and checkpointing
+- Ensures quality gates are met
+
+### `/conductor:status`
+Show current project status and progress.
+
+**Usage:**
+```
+/conductor:status
+```
+
+**What it shows:**
+- Current phase and tasks
+- Completed work with commit references
+- Quality metrics and coverage
+- Next steps and recommendations
+
+### `/conductor:revert`
+Revert changes using git-aware rollback.
+
+**Usage:**
+```
+/conductor:revert
+```
+
+**What it does:**
+- Safely reverts to previous checkpoints
+- Handles track, phase, or task-level rollbacks
+- Preserves git history and notes
+- Updates plan.md accordingly
+
+## Workflow Overview
+
+### 1. Project Setup
+```bash
+# Initialize new project with Conductor
+/conductor:setup
+
+# Review and customize generated files
+# - Edit product.md with your requirements
+# - Update tech-stack.md with your technology choices
+# - Customize workflow.md for your team
+```
+
+### 2. Development Cycle
+```bash
+# Start new feature/track
+/conductor:newTrack
+
+# Work on implementation
+/conductor:implement
+
+# Check progress
+/conductor:status
+
+# Revert if needed
+/conductor:revert
+```
+
+### 3. Quality Gates
+Every task must pass:
+- ✅ All tests pass
+- ✅ Code coverage >80%
+- ✅ Follows style guidelines
+- ✅ Documentation updated
+- ✅ Security review (if applicable)
+
+## Key Features
+
+### Test-Driven Development
+- Enforces Red-Green-Refactor cycle
+- Requires failing tests before implementation
+- Tracks coverage metrics
+- Integrates with project test frameworks
+
+### Git Integration
+- Automatic commit tracking
+- Detailed git notes for audit trail
+- Phase checkpointing
+- Safe rollback capabilities
+
+### Progress Tracking
+- Task status in `plan.md`
+- Commit SHA tracking
+- Phase completion markers
+- Quality gate verification
+
+### Template System
+- Project templates for common setups
+- Code style guides for multiple languages
+- Workflow templates adaptable to any tech stack
+- Product specification templates
+
+## File Structure
+
+After setup, your project will have:
+
+```
+project/
+├── plan.md                    # Main project plan
+├── tech-stack.md             # Technology decisions
+├── product.md                # Product specification
+├── product-guidelines.md     # Design guidelines
+├── workflow.md               # Development workflow
+├── .blackboxignore           # Blackbox exclusions
+└── code_styleguides/         # Style guides
+    ├── general.md
+    ├── javascript.md
+    ├── typescript.md
+    ├── python.md
+    └── go.md
+```
+
+## Best Practices
+
+### Planning
+- Keep tasks small and specific
+- Write clear acceptance criteria
+- Update tech-stack.md before implementation
+- Review product.md regularly
+
+### Implementation
+- Follow TDD strictly (Red-Green-Refactor)
+- Commit frequently with descriptive messages
+- Update plan.md as you complete tasks
+- Run quality checks before marking tasks complete
+
+### Team Collaboration
+- Use consistent commit message format
+- Review and update workflow.md together
+- Share code style guidelines
+- Conduct regular retrospectives
+
+## Customization
+
+### Adapting Templates
+The templates in `templates/` can be customized:
+- Modify `workflow.md` for your team's process
+- Update style guides for your coding standards
+- Customize `product.md` template for your domain
+- Add new templates as needed
+
+### Project-Specific Setup
+- Update `.blackboxignore` for your project structure
+- Modify quality gates in workflow.md
+- Adapt testing requirements
+- Customize deployment processes
+
+## Troubleshooting
+
+### Common Issues
+
+**Q: Tests are failing during implementation**
+A: This is expected in TDD. Write failing tests first (Red), then implement to make them pass (Green), then refactor.
+
+**Q: Can't find previous checkpoint**
+A: Use `/conductor:status` to see available checkpoints, or check git notes with `git notes list`.
+
+**Q: Quality gates are too strict**
+A: Customize the quality requirements in `workflow.md` to match your project needs.
+
+**Q: Extension commands not working**
+A: Ensure the extension is properly installed with `blackbox extensions list`.
+
+## Contributing
+
+To improve the Conductor extension:
+1. Fork the repository
+2. Make your changes
+3. Test with real projects
+4. Submit a pull request
+
+## License
+
+This extension follows the same license as Blackbox CLI.

package/dist/src/built-in-extensions/conductor/blackbox-extension.json

@@ -0,0 +1,5 @@
+{
+  "name": "conductor",
+  "version": "0.1.1",
+  "contextFileName": "BLACKBOX.md"
+}