# Scion

> An experimental multi-agent orchestration testbed that runs multiple AI coding agents in parallel, each in its own container with isolated credentials and git worktree.

Scion is an experimental multi-agent orchestration testbed built by Google Cloud Platform that manages "deep agents" running in isolated containers. It orchestrates agents like Claude Code, Gemini CLI, Codex, and others as concurrent processes, each with its own container, git worktree, and credentials. Rather than prescribing rigid orchestration patterns, Scion takes a "less is more" approach — agents dynamically learn a CLI tool, letting the models themselves decide how to coordinate. It supports local execution, remote VMs, and Kubernetes clusters.

- **Harness Agnostic** — *Works with Gemini CLI, Claude Code, OpenCode, and Codex; adaptable to anything that runs in a container.*
- **True Isolation** — *Each agent runs in its own container with separated credentials, config, and a dedicated `git worktree`, preventing merge conflicts.*
- **Parallel Execution** — *Run multiple agents concurrently as fully independent processes, locally or remotely.*
- **Attach / Detach** — *Agents run in `tmux` sessions for background operation; attach for human-in-the-loop interaction and tunnel into remote agents securely.*
- **Specialization via Templates** — *Define agent roles such as "Security Auditor" or "QA Tester" with custom system prompts and skill sets.*
- **Multi-Runtime** — *Manage execution across Docker, Podman, Apple containers, and Kubernetes via named profiles.*
- **Observability** — *Normalized OTEL telemetry across harnesses for logging and metrics across agent swarms.*
- **Hub-Based Orchestration** — *Optional central control plane for multi-machine orchestration via a Hub and Runtime Broker model.*
- **Quick Install** — *Install from source with `go install github.com/GoogleCloudPlatform/scion/cmd/scion@latest`, then run `scion init` in your project directory.*

## Features
- Multi-agent parallel execution
- Container isolation per agent
- Git worktree per agent
- Harness agnostic (Claude Code, Gemini CLI, Codex, OpenCode)
- tmux-based attach/detach sessions
- Agent templates with custom system prompts
- Multi-runtime support (Docker, Podman, Apple Container, Kubernetes)
- OTEL telemetry and observability
- Hub-based multi-machine orchestration
- CLI-driven agent management
- Remote VM and Kubernetes cluster support
- Human-in-the-loop interaction

## Integrations
Claude Code, Gemini CLI, Codex, OpenCode, Docker, Podman, Kubernetes, Apple Container, tmux, OpenTelemetry, Git

## Platforms
WINDOWS, MACOS, LINUX, API, CLI

## Pricing
Open Source

## Links
- Website: https://github.com/GoogleCloudPlatform/scion
- Documentation: https://googlecloudplatform.github.io/scion/
- Repository: https://github.com/GoogleCloudPlatform/scion
- EveryDev.ai: https://www.everydev.ai/tools/scion