https://github.com/ryaneggz/open-harness
Isolated sandbox images for AI coding agents
https://github.com/ryaneggz/open-harness
agent ai claude-code codex deepagents docker langchain nvidia openclaw openshell sandbox
Last synced: about 2 months ago
JSON representation
Isolated sandbox images for AI coding agents
- Host: GitHub
- URL: https://github.com/ryaneggz/open-harness
- Owner: ryaneggz
- License: mit
- Created: 2026-03-27T04:26:44.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-27T16:29:14.000Z (3 months ago)
- Last Synced: 2026-03-27T16:54:45.061Z (3 months ago)
- Topics: agent, ai, claude-code, codex, deepagents, docker, langchain, nvidia, openclaw, openshell, sandbox
- Language: Shell
- Homepage:
- Size: 84 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mifune Open Harness
**Mifune Open Harness** — run Claude, Codex, Gemini, and Pi side-by-side from one `docker compose up`. Each agent gets its own branch, its own SOUL, its own schedule.
- **Worktree-per-agent.** Each agent gets its own branch, its own SOUL, its own schedule.
- **Agents that work while you sleep.** Cron-driven heartbeats wake them to do real work, autonomously.
- **One container, every agent.** Claude Code, Codex, Pi, Gemini CLI — same sandbox, same toolchain.
- **Only host dependency: Docker.** No Node, no Python, no toolchain rot on your laptop.
- **Composable infra.** Cherry-pick Postgres, Cloudflare tunnels, SSH, Slack, Caddy gateway.
---
## 📦 Install
```bash
curl -fsSL https://raw.githubusercontent.com/ryaneggz/open-harness/refs/heads/main/install.sh | bash
```
Only host dependency: [Docker](https://docs.docker.com/get-docker/). Add `-s -- --with-cli` to also install the `oh` CLI on the host (requires Node 20+).
## 🚀 Quickstart
The full sandbox lifecycle is three commands:
```bash
oh onboard # one-time: GitHub, LLM, Slack, Claude auth wizard
oh sandbox my-agent # provision and start
oh shell my-agent # connect (interactive shell)
oh clean my-agent # tear down
```
Prefer VS Code or remote SSH? See [Connecting to a sandbox](https://github.com/ryaneggz/open-harness/blob/main/docs/getting-started/quickstart.md).
Inside the shell, start working:
```bash
claude # terminal coding agent
pi # automations — Slack, heartbeats, extensions
```
## ✨ What you get
| | |
|---|---|
| **AI agents** | Claude Code, OpenAI Codex, Pi Agent, Mom (Slack bot) |
| **Runtimes** | Node 22, pnpm, Bun, uv (Python) |
| **DevOps** | Docker CLI + Compose, GitHub CLI, cloudflared, tmux, cron |
| **Browser** | agent-browser + Chromium (headless) |
| **Worktree-per-agent** | One branch per agent, one container, shared toolchain |
| **Heartbeats** | Cron-scheduled autonomous runs (`workspace/heartbeats/*.md`) |
## 📚 Where to go next
- [Quickstart](https://github.com/ryaneggz/open-harness/blob/main/docs/getting-started/quickstart.md) — full step-by-step
- [Onboarding](https://github.com/ryaneggz/open-harness/blob/main/docs/getting-started/onboarding.md) — auth wizard walkthrough
- [Compose overlays](https://github.com/ryaneggz/open-harness/blob/main/docs/guide/overlays.md) — Postgres, Slack, SSH, gateway, Cloudflare
- [Slack bot](https://github.com/ryaneggz/open-harness/blob/main/docs/slack/overview.md) — Mom + Pi via Socket Mode
- [CLI reference](https://github.com/ryaneggz/open-harness/blob/main/docs/cli/commands.md) — every `oh` command
- [Heartbeats](https://github.com/ryaneggz/open-harness/blob/main/docs/guide/heartbeats.md) — cron-scheduled autonomous tasks
- [Architecture](https://github.com/ryaneggz/open-harness/blob/main/docs/architecture/orchestrator-worktrees.md) — one container, N worktrees, one daemon
## 🗂️ Project layout
```
.devcontainer/ # Sandbox environment (Dockerfile, compose, overlays)
docs/ # Plain-markdown documentation (GitHub-rendered)
install/ # Provisioning scripts
workspace/ # Agent workspace template (bind-mounted)
packages/
sandbox/ # @openharness/sandbox — CLI + container lifecycle
slack/ # Vendored fork of pi-mom — Slack bot
```
## 🧹 Cleanup
```bash
oh clean my-agent
```
## 🤝 Contributing & community
Issues and PRs welcome at [github.com/ryaneggz/open-harness](https://github.com/ryaneggz/open-harness). If Mifune Open Harness is useful to you, please [give us a star](https://github.com/ryaneggz/open-harness/stargazers).
## 📄 License
MIT.
---
[Full documentation](https://github.com/ryaneggz/open-harness/tree/main/docs)