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