{"id":47426611,"url":"https://github.com/blackboxaicode/cli","last_synced_at":"2026-04-05T06:00:50.889Z","repository":{"id":329555659,"uuid":"1113528426","full_name":"blackboxaicode/cli","owner":"blackboxaicode","description":"BLACKBOX CLI for running Multi-Agents locally and the a Judge to select the best task implementation","archived":false,"fork":false,"pushed_at":"2025-12-30T15:34:09.000Z","size":11002,"stargazers_count":106,"open_issues_count":36,"forks_count":32,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-03T09:49:21.229Z","etag":null,"topics":["agent","code"],"latest_commit_sha":null,"homepage":"https://www.blackbox.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blackboxaicode.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-10T05:21:38.000Z","updated_at":"2026-01-03T04:26:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/blackboxaicode/cli","commit_stats":null,"previous_names":["blackboxaicode/cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/blackboxaicode/cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackboxaicode%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackboxaicode%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackboxaicode%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackboxaicode%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blackboxaicode","download_url":"https://codeload.github.com/blackboxaicode/cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackboxaicode%2Fcli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31426193,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T02:22:46.605Z","status":"ssl_error","status_checked_at":"2026-04-05T02:22:33.263Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","code"],"created_at":"2026-03-22T01:00:43.071Z","updated_at":"2026-04-05T06:00:50.879Z","avatar_url":"https://github.com/blackboxaicode.png","language":"TypeScript","funding_links":[],"categories":["Multi-Agent \u0026 Orchestration"],"sub_categories":["Other IDEs"],"readme":"# Blackbox Code\n\n\u003cdiv align=\"center\"\u003e\n\n![Blackbox Code Screenshot](./docs/assets/blackbox-screenshot.png)\n\n\n\u003c/div\u003e\n\n\n## Key Features\n\n- **Code Understanding \u0026 Editing** - Query and edit large codebases beyond traditional context window limits\n- **Workflow Automation** - Automate operational tasks like handling pull requests and complex rebases\n- **Enhanced Parser** - Adapted parser specifically optimized for BlackboxAI models\n- **Vision Model Support** - Automatically detect images in your input and seamlessly switch to vision-capable models for multimodal analysis\n\n## Installation\n\n### Prerequisites\n\nEnsure you have [Node.js version 20](https://nodejs.org/en/download) or higher installed.\n\n```bash\ncurl -qL https://www.npmjs.com/install.sh | sh\n```\n\n\n### Install from source\n\n```bash\ngit clone https://github.com/blackboxaicode/cli.git\ncd cli\nnpm install\nnpm install -g .\n```\n\n\n## Quick Start\n\n```bash\n# Start Blackbox Code\nblackbox\n\n# Example commands\n\u003e Explain this codebase structure\n\u003e Help me refactor this function\n\u003e Generate unit tests for this module\n```\n\n### Session Management\n\nControl your token usage with configurable session limits to optimize costs and performance.\n\n#### Configure Session Token Limit\n\nCreate or edit `.blackboxcli/settings.json` in your home directory:\n\n```json\n{\n  \"sessionTokenLimit\": 32000\n}\n```\n\n#### Session Commands\n\n- **`/compress`** - Compress conversation history to continue within token limits\n- **`/clear`** - Clear all conversation history and start fresh\n- **`/stats`** - Check current token usage and limits\n\n\u003e **Note**: Session token limit applies to a single conversation, not cumulative API calls.\n\n### Vision Model Configuration\n\nBlackbox Code includes intelligent vision model auto-switching that detects images in your input and can automatically switch to vision-capable models for multimodal analysis. **This feature is enabled by default** - when you include images in your queries, you'll see a dialog asking how you'd like to handle the vision model switch.\n\n#### Skip the Switch Dialog (Optional)\n\nIf you don't want to see the interactive dialog each time, configure the default behavior in your `.blackboxcli/settings.json`:\n\n```json\n{\n  \"experimental\": {\n    \"vlmSwitchMode\": \"once\"\n  }\n}\n```\n\n**Available modes:**\n\n- **`\"once\"`** - Switch to vision model for this query only, then revert\n- **`\"session\"`** - Switch to vision model for the entire session\n- **`\"persist\"`** - Continue with current model (no switching)\n- **Not set** - Show interactive dialog each time (default)\n\n\n#### Disable Vision Models (Optional)\n\nTo completely disable vision model support, add to your `.blackboxcli/settings.json`:\n\n```json\n{\n  \"experimental\": {\n    \"visionModelPreview\": false\n  }\n}\n```\n\n\u003e **Tip**: In YOLO mode (`--yolo`), vision switching happens automatically without prompts when images are detected.\n\n### Authorization\n\nAPI Key Authentication\n\nFor programmatic access or advanced use cases, you can authenticate using an API key:\n\n**Getting Your API Key:**\n\n1. Navigate to the [API Keys section](https://app.blackbox.ai/dashboard) of your BLACKBOX dashboard\n2. Your API key will be displayed on this page\n3. Click the copy icon to copy the key to your clipboard\n4. Run `blackbox configure` and you will be able to set the key \n\n\n\u003e **Important:** Treat your API key like a password! Do not share it publicly or commit it to version control.\n\n\n## Usage Examples\n\n### Explore Codebases\n\n```bash\ncd your-project/\nblackbox\n\n# Architecture analysis\n\u003e Describe the main pieces of this system's architecture\n\u003e What are the key dependencies and how do they interact?\n\u003e Find all API endpoints and their authentication methods\n```\n\n### Code Development\n\n```bash\n# Refactoring\n\u003e Refactor this function to improve readability and performance\n\u003e Convert this class to use dependency injection\n\u003e Split this large module into smaller, focused components\n\n# Code generation\n\u003e Create a REST API endpoint for user management\n\u003e Generate unit tests for the authentication module\n\u003e Add error handling to all database operations\n```\n\n### Automate Workflows\n\n```bash\n# Git automation\n\u003e Analyze git commits from the last 7 days, grouped by feature\n\u003e Create a changelog from recent commits\n\u003e Find all TODO comments and create GitHub issues\n\n# File operations\n\u003e Convert all images in this directory to PNG format\n\u003e Rename all test files to follow the *.test.ts pattern\n\u003e Find and remove all console.log statements\n```\n\n### Debugging \u0026 Analysis\n\n```bash\n# Performance analysis\n\u003e Identify performance bottlenecks in this React component\n\u003e Find all N+1 query problems in the codebase\n\n# Security audit\n\u003e Check for potential SQL injection vulnerabilities\n\u003e Find all hardcoded credentials or API keys\n```\n\n## Popular Tasks\n\n### Understand New Codebases\n\n```text\n\u003e What are the core business logic components?\n\u003e What security mechanisms are in place?\n\u003e How does the data flow through the system?\n\u003e What are the main design patterns used?\n\u003e Generate a dependency graph for this module\n```\n\n### Code Refactoring \u0026 Optimization\n\n```text\n\u003e What parts of this module can be optimized?\n\u003e Help me refactor this class to follow SOLID principles\n\u003e Add proper error handling and logging\n\u003e Convert callbacks to async/await pattern\n\u003e Implement caching for expensive operations\n```\n\n### Documentation \u0026 Testing\n\n```text\n\u003e Generate comprehensive JSDoc comments for all public APIs\n\u003e Write unit tests with edge cases for this component\n\u003e Create API documentation in OpenAPI format\n\u003e Add inline comments explaining complex algorithms\n\u003e Generate a README for this module\n```\n\n### Development Acceleration\n\n```text\n\u003e Set up a new Express server with authentication\n\u003e Create a React component with TypeScript and tests\n\u003e Implement a rate limiter middleware\n\u003e Add database migrations for new schema\n\u003e Configure CI/CD pipeline for this project\n```\n\n## Commands \u0026 Shortcuts\n\n### Session Commands\n\n- `/help` - Display available commands\n- `/clear` - Clear conversation history\n- `/compress` - Compress history to save tokens\n- `/stats` - Show current session information\n- `/exit` or `/quit` - Exit Blackbox Code\n\n### Keyboard Shortcuts\n\n- `Ctrl+C` - Cancel current operation\n- `Ctrl+D` - Exit (on empty line)\n- `Up/Down` - Navigate command history\n\n## Acknowledgments\n\nThis 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.\n\n## License\n\n[LICENSE](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackboxaicode%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackboxaicode%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackboxaicode%2Fcli/lists"}