Agent Integration

How It Works

Buildlog uses a simple file-based protocol for agent integration. AI agents write JSON entries to a feed file, and the Buildlog extension captures them as workflow steps.

⚡ Option 1: MCP Server (Recommended)

The easiest way to integrate is via our MCP server. It handles all the recording automatically and gives agents the ability to search and follow existing workflows.

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "buildlog": {
      "command": "npx",
      "args": ["@buildlogai/mcp"]
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "buildlog": {
      "command": "npx",
      "args": ["@buildlogai/mcp"]
    }
  }
}

Environment Variables

For uploading, set your API key (get one from Settings):

export BUILDLOG_API_KEY=bl_your_api_key_here

📝 Option 2: Direct Feed File

For custom integrations, agents can write directly to the feed file. Each line is a JSON object with one of these types:

Entry Types

{"type":"prompt","raw":"Add a login button...","content":"Add login button"}

{"type":"action","summary":"Created LoginButton component","filesModified":["src/LoginButton.tsx"]}

{"type":"note","content":"Using React context for auth state"}

Example: Bash

# Log a prompt
echo '{"type":"prompt","raw":"Add authentication","content":"Add auth"}' >> ~/.buildlog/agent-feed.jsonl

# Log an action
echo '{"type":"action","summary":"Added auth middleware","filesModified":["middleware.ts"]}' >> ~/.buildlog/agent-feed.jsonl

Example: Python

import json
import os
from pathlib import Path

feed_path = Path.home() / ".buildlog" / "agent-feed.jsonl"
feed_path.parent.mkdir(exist_ok=True)

def log_entry(entry: dict):
    with open(feed_path, "a") as f:
        f.write(json.dumps(entry) + "\n")

# Log a prompt
log_entry({
    "type": "prompt",
    "raw": "Implement user authentication with OAuth",
    "content": "Add OAuth authentication"
})

# Log an action
log_entry({
    "type": "action",
    "summary": "Created OAuth handler and callback routes",
    "filesModified": ["auth/oauth.py", "routes/callback.py"]
})

🔧 VS Code Extension

The Buildlog VS Code extension watches the feed file and automatically captures entries into the current recording session.

1. Install the extension from the VS Code Marketplace
2. Start a recording session (Cmd+Shift+P → "Buildlog: Start Recording")
3. Your AI agent writes to ~/.buildlog/agent-feed.jsonl
4. Entries are automatically added to your buildlog
5. Stop recording and upload to buildlog.ai

Troubleshooting

echo '{"type":"note","content":"Test entry from terminal"}' >> ~/.buildlog/agent-feed.jsonl