# BLACKBOX AI on VSCode

Welcome to BLACKBOXAI - The best AI Coding Agent that can create, edit, and manage files, run commands, and help you build great products!

## Key Features

### File Operations

* Create new files and directories
* Edit existing files with intelligent diffs
* Search and replace across multiple files
* Manage project structure

### Command Execution

* Run terminal commands
* Install dependencies
* Start development servers
* Execute build scripts

### Web Browsing

* Navigate websites for research
* Test your applications
* Interact with web interfaces
* Capture screenshots

### Smart Context

* Understands your project structure
* Maintains conversation history
* Learns from your preferences
* Provides relevant suggestions

### Voice with the Agent

* Natural voice conversations with AI
* Hands-free coding assistance
* Real-time voice commands
* Audio feedback and responses

### Agent with GPUs

* Let the BLACKBOXAI Coding Agent run an any GPU
* Let the Agent process the training data
* Let the Agent do finetuning

## Feature Media Gallery

### Feature Demonstrations

#### File Operations Interface

![File Selection Interface](https://storage.googleapis.com/workspace-0f70711f-8b4e-4d94-86f1-2a93ccde5887/workspace:file:UOn2aumVkIrZK1rLPwNBg:0)

The file operations interface allows you to manage your project files efficiently.

#### Voice Commands Demo

[Video: Voice Commands Demo](https://storage.googleapis.com/workspace-0f70711f-8b4e-4d94-86f1-2a93ccde5887/commit-voice.mp4)

See how voice commands can streamline your coding workflow.

#### Agent on GPUs

[Video: Agent on GPUs](https://storage.googleapis.com/workspace-0f70711f-8b4e-4d94-86f1-2a93ccde5887/gpu.mp4)

Experience the power of GPU with the BLACKBOXAI Agent

## Keyboard Shortcuts

* `Ctrl+I` / `Cmd+I` - Copy file content to chat
* `Ctrl+Shift+P` - Open command palette

## Configuration

### API Providers

Blackbox AI supports multiple AI providers:

* **Anthropic Claude** - Recommended for most tasks
* **OpenAI GPT** - Great for general coding tasks
* **Google Gemini** - Good for multimodal tasks
* **Local Models** - Ollama, LM Studio support

![Model Selection Interface](https://storage.googleapis.com/workspace-0f70711f-8b4e-4d94-86f1-2a93ccde5887/workspace:file:UOn2aumVkIrZK1rLPwNBg:2)

### Agent Commands

![Agent Commands Interface](https://storage.googleapis.com/workspace-0f70711f-8b4e-4d94-86f1-2a93ccde5887/vscode-commands.png)

### Chat Settings

* **Mode** - Switch between Auto and Manual modes for different levels of control
* **Custom Instructions** - Add your coding preferences
* **Always Allow Read-Only** - Auto-approve file reading

![Mode Selection Interface](https://storage.googleapis.com/workspace-0f70711f-8b4e-4d94-86f1-2a93ccde5887/workspace:file:UOn2aumVkIrZK1rLPwNBg:3)

## Credit System

### Credit Allocation

As a subscriber, you receive credits that allow you to use Blackbox AI's features:

* Credits are automatically allocated with your subscription
* Your credit balance refreshes at the start of each subscription period
* Monitor your credit usage in the Settings tab

### Credit Management

When your credits are running low:

* **Manual Refill** - Purchase additional credits at any time
* **Auto Refill** - Enable automatic credit purchases when your balance is low
* **Usage Tracking** - Monitor your credit consumption in real-time

> **Pro Tip:** Enable auto refill to ensure uninterrupted access to Blackbox AI's features. You can set custom thresholds and limits for automatic refills in the Credits tab.

## Best Practices

### Writing Effective Prompts

* Be specific about what you want to achieve
* Mention the technologies you want to use
* Provide context about your project
* Break complex tasks into smaller steps

### Project Organization

* Keep your workspace organized
* Use meaningful file and folder names
* Add comments to complex code
* Review changes before approving

> **Security:** Always review commands and file changes before approving them. Blackbox AI will ask for permission before making any changes to your system.

## Advanced Features

### MCP (Model Context Protocol)

Extend Blackbox AI's capabilities with MCP servers for additional tools and integrations. Connect to various MCP servers to enhance your development workflow with specialized features and integrations.

![MCP Servers Interface](https://storage.googleapis.com/workspace-0f70711f-8b4e-4d94-86f1-2a93ccde5887/workspace:file:UOn2aumVkIrZK1rLPwNBg:1)