Sunaba Cli

sunaba-cli

[](LICENSE) [](https://www.python.org/downloads/)

日本語版は [README.ja.md](README.ja.md) にあります。

**One-command devcontainer sandboxes for AI agent development.**

`sunaba` (Japanese for "sandbox") scaffolds isolated, disposable devcontainer environments pre-wired for [Claude Code](https://claude.com/claude-code), [OpenAI Codex CLI](https://github.com/openai/codex), and the [Google Antigravity CLI](https://antigravity.google) (`agy`, the successor to Gemini CLI) — plus MCP servers, cloud SDKs, and project scaffolding. Break it, throw it away, make another one.

---

Why

AI coding agents are powerful but messy: they install global packages, fetch random scripts, and mutate your machine in surprising ways. `sunaba-cli` gives you a **fresh, isolated Linux container per project** with all three major agents pre-installed and pre-configured to talk to each other via MCP.

• 🧪 Disposable — if an agent breaks something, rebuild the container
• 🔌 Composable — mix and match stacks (python, nextjs, aws, gcp, …)
• 🤖 Agents talk to each other — Claude Code can call Codex as an MCP sub-agent, and the Antigravity CLI (agy) headlessly
• 🔐 Opt-in secrets — API keys only injected when you ask for them (--stack agents)
• 📦 Self-contained — uv tool install gives you a global sunaba command

Install

Requires [uv](https://docs.astral.sh/uv/):

uv tool install git+https://github.com/morimorijap/sunaba-cli

You now have a `sunaba` command on your PATH.

Upgrade

sunaba upgrade

Quick start

# Interactive stack picker
sunaba new myapp

# Explicit stacks
sunaba new myapp --stack python --stack agents

cd myapp
code .
# VS Code: Cmd+Shift+P → "Dev Containers: Reopen in Container"

The first container start takes a few minutes while base images and agent CLI