GotchiBot

Multi-agent orchestrator for running a fleet of autonomous agents from one cockpit.

Year
2026
Role
Solo build — architecture, CLI, orchestrator, MCP tooling, distribution
Discipline
Agent Orchestration

The problem

Running more than one autonomous agent quickly stops being a model problem and becomes an operations problem. Each agent needs its own credentials, its own working directory, its own model tier, and its own restart policy, and the moment something goes wrong you need to know which agent did it and how to stop it. Doing that with loose shell scripts does not survive past about three agents.

The approach

GotchiBot is a cross-platform orchestrator that treats agents as managed processes with identity. It supports two topologies — Solo, where one operator runs agents on a single machine, and Fleet, where an always-on host coordinates many. A tmux-based cockpit gives a live view of every running agent, with spawn, attach, and monitoring as first-class commands. Agents get scoped credentials through abracadabra rather than environment files, model tiering is declared in configuration rather than hard-coded, and MCP servers expose the orchestrator's own capabilities back to the agents it runs. Onboarding is wallet-based: an operator connects a wallet, receives a per-install token, and authenticates against shared infrastructure without ever holding operator secrets. The fleet also has working tools rather than just a supervisor: a PyMuPDF-backed PDF tool exposed over CLI and MCP so agents can extract, search, and chunk documents for retrieval; a meeting layer that wakes agents on a checklist, chairs their summaries with a question round, and writes end-of-meeting handoff notes; and a bridge that routes fleet prompts through the Claude Code CLI on the host, with jobs submitted asynchronously and collected when the answer lands.

Outcome

GotchiBot runs a live agent fleet on a home host behind a Cloudflare tunnel, coordinating agent processes, a Docker-backed simulation service, a MongoDB store, and a self-hosted Ollama content pipeline. It ships as open source under PolyForm Noncommercial with a separate commercial entitlement, and installs update themselves from a signed release manifest.

Details

  • Solo and Fleet topologies from one codebase — macOS, Linux, and Windows (WSL2)
  • tmux cockpit for spawning, attaching to, and monitoring live agents
  • MCP servers expose orchestrator capabilities to the agents it supervises — cron402 scheduling, PDF extraction, meeting flows, and hub status
  • PyMuPDF PDF tool over CLI and MCP: check, info, text, render, search, and RAG-ready chunks
  • Morning recap and meeting flows: agents wake on a checklist, report, take questions, and leave handoff notes
  • Claude bridge: a VS Code extension routes fleet prompts through the Claude Code CLI and pushes results across the LAN
  • Per-install tokens from a wallet onboarding flow — operators never hold shared secrets
  • Self-updating from a release manifest with CDN, API, and GitHub raw fallbacks
  • Open source under PolyForm Noncommercial with a separate commercial tier

Built with

  • TypeScript
  • Node.js
  • MCP
  • Docker
  • Cloudflare
  • MongoDB
  • Ollama
  • Python
  • Base
  • tmux

Links

Need something like this? AI Agent Orchestration is what I do.

Last updated .