Getting Started

Step-by-step guide to install and set up the BLACKBOX AI VS Code extension.

Installation and Setup

Follow these simple steps to get started with BLACKBOX AI in VS Code:

Step 1: Install the Extension

You can install the BLACKBOX AI extension in two ways:

Option A: From VS Code Open VS Code, navigate to the Extensions view (Ctrl+Shift+X), search for “BLACKBOX AI”, and click Install.

Option B: From VS Code Marketplace Visit the BLACKBOX AI extension page on the VS Code Marketplace and click Install.

Step 2: Find the AI Agent Icon

After installation, you’ll see the AI Agent icon appear on the right side of your VS Code interface.

Step 3: Connect Your Account

Click on the AI Agent icon and connect your BLACKBOX AI account to start using the extension.

Step 4: Start Using AI Assistance

Now you can start giving tasks to the BLACKBOX AI Coding Agent for both new projects and existing project improvements.

Step 5: Customize Your Workspace

Customize the extension chat window according to your preference by simply dragging it around your VS Code interface. Position it wherever works best for your workflow.

Additional Configurations/Customizations

Tool Configuration

Tools are ways to enable additional functionality and power to the BLACKBOX agent to perform various development-related tasks. You can control tools by clicking on the controls icon beside the settings button, selecting tools, and toggling any tool on or off.

For example, the browser tool allows the agent to launch and control a browser to navigate websites, interact with web elements, capture screenshots, and test web applications in real-time.

Fine-Grained Auto-Approval

When you enable Auto mode for tool execution, you can still retain control over which operations are auto-approved.
Open the Tools configuration from the chat overflow menu (or the edit icon next to the Auto/Manual toggle) to independently enable or disable auto-approval for:

• Edit file
• Create file
• Command execution
• Read file

These fine-grained settings are only applied while Auto mode is on; in Manual mode, every tool use requires your explicit approval as usual.

You’re Ready to Go!

With the extension installed and your account connected, you’re ready to experience AI-powered development directly in VS Code. The AI agent is now available to help you with any coding task, from creating new projects to improving existing code.