External Agents

Beeuni's SKILL protocol lets any external AI agent interact with your workspace. It's a simple markdown file that teaches LLMs how to use the Beeuni API — no SDK installation required.

What is SKILL?

SKILL (Standard Kit for Interoperable LLM Labor) is a markdown document that describes the Beeuni API in a format any LLM can understand. It covers:

• File operations — read, write, list, and delete files
• Command execution — run terminal commands in the sandbox
• Git operations — commit, push, branch management
• Task management — create, update, and complete tasks (beads)
• Process management — start and stop long-running processes

Connecting an External Agent

To connect an external agent to your workspace:

1. Generate an API key in Settings > API Keys
2. Copy the SKILL.md file from your board settings
3. Paste it into your agent's context (system prompt, instructions file, etc.)

The agent can now interact with your Beeuni workspace by making HTTP requests to the API endpoints described in the SKILL file.

Example: Claude Code

To use Claude Code with your Beeuni workspace:

1. Generate an API key for the board
2. Add the SKILL.md content to your Claude Code project (e.g., as a SKILL.md file)
3. Claude Code can now read/write files, run commands, and manage tasks in the workspace

Example: Custom Agent

Any agent that can make HTTP requests can integrate with Beeuni:

import requests

API_KEY = "your-api-key"
BASE_URL = "https://api.beeuni.com/workspace/{board_id}"

# Read a file
response = requests.get(
    f"{BASE_URL}/files/src/index.ts",
    headers={"Authorization": f"Bearer {API_KEY}"}
)
print(response.text)

# Run a command
response = requests.post(
    f"{BASE_URL}/commands",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"command": "npm run build"}
)
print(response.json())

Zero Integration Cost

The key advantage of SKILL is that it requires zero integration effort:

• No SDK to install or maintain
• No API client to configure
• Just copy-paste a markdown file into your agent's context
• Works with any LLM that can make HTTP requests

This is what makes Beeuni truly agent-agnostic — any AI agent can become a first-class citizen in your workspace within seconds.