blackbox-integrations

name	blackbox-integrations
description	Guides connecting Blackbox AI with third-party services and tools including IDEs (VS Code, PyCharm, IntelliJ), version control (GitHub, GitLab, Bitbucket), project management (Jira, Linear, Asana), communication (Slack, Teams), and external APIs and SDKs. Activates when integrating Blackbox with external tools.
metadata	{"author":"tradecraft","version":"1.0.0"}

Blackbox AI Integrations

Blackbox AI integrates with 35+ IDEs, major version control platforms, project management tools, communication channels, CI/CD pipelines, and provides SDKs for Python, JavaScript, Java, and Go.

When to Use This Skill

• Connecting Blackbox AI with your IDE (VS Code, JetBrains, Xcode, etc.)
• Integrating with GitHub, GitLab, or Bitbucket workflows
• Setting up Slack or Teams integration for agent notifications
• Connecting project management tools (Jira, Linear, Asana)
• Using the Python or JavaScript SDK
• Configuring CI/CD integration with GitHub Actions or Jenkins
• Setting up webhook-based automation

Quick Start

IDE Integration

Install the Blackbox AI extension for your IDE:

VS Code: Search "BLACKBOX AI" in Extensions marketplace JetBrains (PyCharm, IntelliJ, WebStorm): Install from JetBrains marketplace Xcode: Install Blackbox Xcode extension

SDK Installation

Python:

pip install blackbox-ai-sdk --upgrade

JavaScript/Node.js:

npm install @blackbox-ai/client

Core Concepts

IDE Support Matrix

IDE	Support Level	Notes
VS Code	Primary	4.7M+ installs, deepest integration
PyCharm	Full	JetBrains plugin
IntelliJ IDEA	Full	JetBrains plugin
WebStorm	Full	JetBrains plugin
Android Studio	Full	JetBrains plugin
Xcode	Full	Native extension
Google Colab	Supported	Jupyter environment
Jupyter Notebook	Supported	Data science workflows
Zed (ACP)	Supported	Agent Control Protocol
35+ more	Various	See full list in references

Version Control

Platform	Features
GitHub	Webhooks, repos, branches, issues, organizations, PR automation
GitLab	Repository integration, CI/CD
Bitbucket	Repository integration

Communication Tools

Tool	Features
Slack	Agent integration, notifications, task assignment
Microsoft Teams	Notifications, task management
SMS	Task assignment via text message
Voice Calls	Hands-free task management
WhatsApp	Up to 12 parallel agents (experimental)

Project Management

Tool	Features
Jira	Automated feature branch scaffolding, issue tracking
Linear	Issue tracking, project management
Asana	Task management
Notion	Documentation syncing

CI/CD

Platform	Integration
GitHub Actions	Automated workflows
Jenkins	Pipeline integration
CircleCI	Build automation

SDKs

Python SDK

# pip install blackbox-ai-sdk --upgrade
from blackbox_ai import BlackboxClient

client = BlackboxClient(api_key="your-key")
response = client.chat("Explain this code", context="def fib(n): ...")
print(response.content)

JavaScript/Node.js SDK

// npm install @blackbox-ai/client
import { BlackboxClient } from "@blackbox-ai/client";

const client = new BlackboxClient({ apiKey: "your-key" });
const response = await client.chat("Explain this code", {
  context: "function fib(n) { ... }",
});
console.log(response.content);

API Access

Protocol	Description
REST API	Primary API at api.blackbox.ai
GraphQL	Available for complex queries
Webhooks	Event-driven integrations

Common Patterns

GitHub + Slack Workflow

1. Connect GitHub repo to Blackbox AI
2. Configure Slack webhook for notifications
3. Agent creates PR on GitHub
4. Notification sent to Slack channel
5. Team reviews and merges

Jira-Driven Development

1. Connect Jira project
2. Agent reads Jira ticket requirements
3. Automatically creates feature branch
4. Implements the feature
5. Creates PR linked to Jira ticket

SDK Integration in CI/CD

# .github/workflows/code-review.yml
name: AI Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: pip install blackbox-ai-sdk
      - run: python scripts/ai-review.py
        env:
          BLACKBOX_API_KEY: ${{ secrets.BLACKBOX_API_KEY }}

Troubleshooting

Issue	Fix
IDE extension not loading	Restart IDE, check for updates
GitHub webhook not firing	Verify webhook URL and secret
Slack notifications missing	Check bot permissions and channel
SDK authentication error	Verify API key is valid
CI/CD integration fails	Check environment variable is set

References

• See references/integrations-list.md for full integration details