Ghostbox

Ghostbox

Persistent AI agents in isolated Docker containers. Each ghost gets its own vault, its own memory, and evolves across sessions.

---

What is this

Ghostbox lets you create isolated AI agents, each with their own sandboxed environment and persistent vault. Agents self-evolve - building tools, refining instructions, growing their knowledge base - and save their updates to GitHub.

Each agent has:

• A vault - persistent git-backed filesystem that survives restarts
• A memory system - warm facts injected into every session + deep knowledge searchable on demand
• Full coding capabilities - file I/O, bash, package installation, server hosting
• Self-evolution - agents build their own tools, refine their own instructions, grow their knowledge base

The host orchestrator manages container lifecycle, routes messages via Telegram or the REST API, and handles git persistence. A native macOS app provides a local interface.

Quick start

npx @bootoshi/ghostbox init

This runs the setup wizard: configures API keys, builds the Docker image, and creates your first ghost.

# Spawn a ghost
ghostbox spawn researcher --model anthropic/claude-sonnet-4-6

# Talk to it
ghostbox talk researcher "Explore the codebase and save what you learn"

# Start the Telegram bot
ghostbox bot

Architecture

Host (Bun)                               Docker Containers
+------------------------------------+
|  CLI / API / Telegram              |   +------------------------+
|                                    |   | ghostbox-researcher    |
|  +-----------+  +---------------+  |   |  /vault (mounted)      |
|  | telegram  |->| orchestrator  |--+-->|  ghost-server.ts       |
|  +-----------+  +---------------+  |   |  Pi Agent SDK          |
|  | api.ts    |->|               |  |   |  memory + qmd          |
|  +-----------+  +----+-----