https://github.com/peteknowsai/cells-md
A fleet of AI agents, each in its own little Linux machine.
https://github.com/peteknowsai/cells-md
ai-agents bun cloudflare-workers local-first substrate
Last synced: 1 day ago
JSON representation
A fleet of AI agents, each in its own little Linux machine.
- Host: GitHub
- URL: https://github.com/peteknowsai/cells-md
- Owner: peteknowsai
- License: mit
- Created: 2026-05-20T00:44:49.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-17T21:58:52.000Z (4 days ago)
- Last Synced: 2026-06-17T22:22:22.884Z (4 days ago)
- Topics: ai-agents, bun, cloudflare-workers, local-first, substrate
- Language: TypeScript
- Homepage: https://www.cells.md
- Size: 2.95 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Roadmap: docs/ROADMAP.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# cells
A fleet of AI agents, each in its own little Linux machine.
You hand it a problem. It builds the team — a Chief of Staff with cells under it, each owning a piece of the work, all running on your Mac.
---
## Status — alpha
This is being built in the open. **You cannot run it on a fresh machine yet.**
A working install needs:
- **[wells](https://github.com/peteknowsai/wells)** running first — the substrate that owns the Linux VMs (see below)
- a proxy bridge (`cells-proxy`) that routes a cell's LLM calls through your own Claude Max / ChatGPT Plus subscriptions instead of API billing
- two consumer subscriptions in good standing (Anthropic + OpenAI)
Cells is the layer above all of that — the CLI, the birth ritual, the agent-to-agent channel, the per-cell Cloudflare worker. The substrate itself isn't self-serve yet. If you want to follow along, the design docs in `docs/proposals/` are the best entry point.
## What it is
- A cell is a little Linux machine on your Mac with one agent inside it.
- Cells talk to each other — `cells talk` for ask-and-answer, `cells verify` for cross-checked decisions.
- Cells get a public web presence at `.cells.md`, served via a per-cell Cloudflare Durable Object — they stay reachable when the laptop sleeps.
- Birth happens via "mother," a special cell that runs a deterministic birthing ritual. Hand it a JSON blob, get back a working cell.
- Three harnesses today: **pi** (full agent stack), **claude-code** (Anthropic's CLI), **codex** (OpenAI's CLI). All three speak the same channels primitive.
For the long form, see [`docs/proposals/what-is-cells.html`](docs/proposals/what-is-cells.html).
## Runs on wells
Cells is the top layer. Underneath it is **[wells](https://github.com/peteknowsai/wells)** — the substrate that owns the Linux VMs cells live in. A daemon on your Mac brings a stateful VM up on demand; cells is the agent that lives inside it.
**Cells cannot run without wells.** It's a hard dependency, not an option: wells makes the machine, cells makes it think. Bring up wells first, then `cells birth` onto it.
## Layout
```
cli/ Mac-side CLI (cells, dashboard, host-bridge, proxy, worker/)
dna/ The DNA every cell inherits — base/, specials/ (mother, pulse), skills
docs/ Design docs and proposals — HTML-primary
scripts/ Birth, acceptance, harden, eval scripts
colonies/ Multi-cell recipes (e.g. jurypool)
```
## Built with
- [Bun](https://bun.sh) — runtime
- [Cloudflare Workers + Durable Objects](https://workers.cloudflare.com) — per-cell network presence
- [pi](https://pi.ai) (the CLI) and [claude-code](https://claude.com/claude-code) — agent harnesses
## License
MIT. See [LICENSE](LICENSE).