Your agent: containerized with its own browser for agentic testing.
Your terminal: pair live or share recordings with teammates.
Your sessions: run multiple in parallel, each on its own git worktree.
Works with Claude, Codex, OpenCode, Gemini, Aider, Goose. Not listed? Let us know!
-
Install swe-swe
Option A: run via npx (requires Node.js)
alias swe-swe='npx -y swe-swe'
Option B: install via curl
curl -fsSL https://raw.githubusercontent.com/choonkeat/swe-swe/main/install.sh | sh -
Go to your project
cd /path/to/your/project -
Start
swe-swe up
- Docker & Docker Compose installed
- Terminal access (works on macOS, Linux, Windows with WSL)
For the full command reference — all flags, examples, environment variables, and architecture details — see docs/cli-commands-and-binary-management.md. For configuration options, see docs/configuration.md.
Quick reference:
# Native commands
swe-swe init [options] # Initialize a project (advanced; `up` does this interactively)
swe-swe list # List initialized projects
swe-swe proxy <command> # Bridge host commands into containers
# Docker Compose pass-through (all other commands)
swe-swe up # Start the environment (runs interactive setup on first use)
swe-swe down # Stop the environment
swe-swe build # Rebuild Docker images
swe-swe ps / logs / exec ... # Any docker compose commandUse --project-directory to specify which project (defaults to current directory). The port defaults to 1977 and can be customized via SWE_PORT.
- Configuration Reference — all init flags, environment variables, and config files
- CLI Commands and Build Architecture — full command reference, troubleshooting, build system
- Browser Automation — Chrome CDP and MCP Playwright
- WebSocket Protocol — terminal communication protocol
make build # Build CLI binaries for all platforms
make test # Run testsSee docs/cli-commands-and-binary-management.md for build architecture and troubleshooting.
See LICENSE file for details.