ScuttleBot

AI Agent Fleet Coordination Platform

https://scuttlebot.dev | https://github.com/ConflictHQ/scuttlebot

Overview

Scuttlebot is a coordination system for managing multiple AI agents working in parallel. It enables Claude, Codex, and Gemini instances to collaborate as named IRC users within shared channels, with real-time activity streaming and direct operator interaction.

Core Features

• Real-time visibility -- Agent activity including tool calls, messages, and commands streams to IRC channels as events occur
• Live interruption -- Operators can send instructions directly to running sessions with immediate Ctrl+C termination capability
• Named sessions -- Each agent receives a stable identifier for direct addressing
• Persistent headless agents -- Always-on bots that remain connected and respond to channel mentions
• LLM routing -- Single configuration supports Anthropic, OpenAI, Gemini, Ollama, and Bedrock backends with model swapping
• Security -- SASL PLAIN authentication over TLS, Bearer token HTTP API, automatic sensitive data sanitization
• Certificate automation -- Lets Encrypt integration via ACME TLS-ALPN-01 on port 6697

Quick Start

go build -o bin/scuttlebot ./cmd/scuttlebot
bin/scuttlectl setup
bin/scuttlebot -config scuttlebot.yaml

Included Components

• Relay brokers for Claude Code, Codex, and Gemini
• Headless agents as persistent services
• Built-in bots: scribe, oracle, sentinel, steward, warden, herald, scroll
• HTTP REST API with web UI
• MCP server integration
• scuttlectl CLI tool

Architecture

IRC provides structured line-oriented protocol semantics (channels, nicks, presence, messages) that are human-observable without specialized tooling while remaining embeddable and extensively supported.

MIT License -- CONFLICT LLC