菜单
Guides usage of the Blackbox AI Desktop Agent, including desktop automation, MCP client connections, control modes (Full Autonomy, Approval Required, Chat Only), and .blackboxignore file exclusion. Activates when configuring or troubleshooting the Desktop Agent.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Guides usage of the Blackbox AI API, including OpenAI-compatible endpoints, model routing, web search API, image generation, video generation, function calling, streaming responses, and multi-agent task orchestration via REST API. Activates when working with Blackbox API calls, provider routing, or SDK integration.
Guides usage of Blackbox Builder (build.blackbox.ai) for vibe coding full-stack apps from natural language, deploying to Blackbox hosting, and rapid prototyping. Activates when building apps with Builder, using voice input, or deploying to Blackbox hosting.
Guides usage of the Blackbox AI CLI terminal agent, including installation, configuration, database chat, multi-agent parallel execution, remote tasks, and skill management. Activates when working with terminal-based Blackbox AI workflows or CLI commands.
Guides Blackbox AI Enterprise features including team management, SSO/SAML configuration, role-based access control, model aliases, compliance (SOC2, HIPAA), usage monitoring, and enterprise deployment options. Activates when setting up teams, SSO, RBAC, or compliance.
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.
Guides creating, managing, and authoring Blackbox AI skills, including the .blackbox/skills/ directory structure, /skill CLI commands, and cross-platform skill compatibility with both Blackbox AI and Claude Code. Activates when building or organizing skills.
| name | blackbox-desktop |
| description | Guides usage of the Blackbox AI Desktop Agent, including desktop automation, MCP client connections, control modes (Full Autonomy, Approval Required, Chat Only), and .blackboxignore file exclusion. Activates when configuring or troubleshooting the Desktop Agent. |
| compatibility | Requires Blackbox Desktop Agent installed. Available for macOS, Windows, and Linux. |
| metadata | {"author":"tradecraft","version":"1.0.0"} |
The Blackbox AI Desktop Agent is a standalone application for Windows, macOS, and Linux that provides AI-powered coding assistance with full autonomy controls, MCP client integration, and cross-application automation.
.blackboxignore files for file exclusionDownload from app.blackbox.ai:
| Platform | Requirement |
|---|---|
| macOS (Apple Silicon) | macOS 10.15+, DMG installer |
| macOS (Intel) | macOS 10.15+, DMG installer |
| Windows | Windows 10/11 64-bit, EXE installer |
| Linux | Ubuntu/Fedora/Debian, .deb/.rpm/AppImage |
| Mode | Description | Best For |
|---|---|---|
| Full Autonomy | Agent works independently without intervention | Trusted tasks, automation |
| Approval Required | Review and approve each action | Learning, sensitive code |
| Chat Only | Conversational assistance, no automated actions | Q&A, brainstorming |
Switch modes from the agent settings panel.
The Desktop Agent acts as an MCP (Model Context Protocol) client, connecting to external tools and services.
Generate MCP Token:
Connect MCP Server:
blackbox mcp add remote-code https://cloud.blackbox.ai/api/mcp \
-t http \
-H "Authorization: Bearer <your-mcp-token>"
Verify: Look for "using 1:MCP server" in terminal output.
Discover tools: Press Ctrl+t or ask "print all the remote-code tools"
See references/mcp-setup.md for detailed MCP configuration.
Create a .blackboxignore file in your project root:
# .blackboxignore
node_modules/
dist/
build/
.env
.env.local
*.log
*.lock
coverage/
.next/
__pycache__/
Same syntax as .gitignore. Excludes files from:
| Feature | Description |
|---|---|
| End-to-End Encryption | Industry-standard encryption for all communications |
| Local Encryption | Data encrypted on device before transmission |
| File Protection | .blackboxignore for sensitive file exclusion |
| Access Control | Full control over what the agent can access and modify |
| Zero-Knowledge | Server cannot access your sensitive work |
1. Set mode to "Full Autonomy"
2. Describe the task: "Refactor all API routes to use Zod validation"
3. Agent works through all files autonomously
4. Review changes in git diff when complete
1. Set mode to "Approval Required"
2. Ask: "Add error handling to the payment processing module"
3. Review each proposed change
4. Approve or reject individually
1. Connect MCP servers for external tools
2. Agent can now access remote resources
3. "Use the database MCP to check the current schema, then add a migration"
| Issue | Fix |
|---|---|
| Installation fails | Check OS requirements and permissions |
| MCP connection fails | Verify token and endpoint URL |
| High token usage | Add more entries to .blackboxignore |
| Agent unresponsive | Restart the application |
| Files not excluded | Check .blackboxignore syntax and location |
references/capabilities.md for full capability listreferences/mcp-setup.md for MCP server configuration