Scion

sci·on /ˈsīən/ — a young shoot or twig, cut for grafting or rooting.

An open foundation for agent collaboration.

Build teams of AI agents that delegate, share findings, and work alongside you. Bring your choice of harnesses and models, shape how they collaborate, and run them on your laptop or across cloud infrastructure.

Get StartedGitHubDocumentation

Scion Core

Simple building blocks for teams that adapt as the work unfolds.

🌱
SCION.
Multi-Agent Orchestration Explainer

Scion Core

Define responsibilities. Run agents. Delegate, communicate, and share the work.

01

Define

Agent Templates

02

Run

Sandbox Runtimes

03

Spawn

Adaptive Teams

04

Notify

Reactive Wakeups

05

Sync

Shared Filesystem

Agent Definition

Combine reusable instructions, skills, and tools to give each agent a clear purpose.

1. System Instruction

Define the agent's purpose and responsibilities, from research and implementation to independent review.

2. Agent Instructions

Describe how the agent works with its team. Scion adds context about the workspace and available capabilities.

3. Agent Skills

Give agents reusable procedures and tool guidance. Publish and version skills through the Skill Bank and connected registries.

4. Model Context Protocol (MCP)

Connect external tools and data through MCP server configuration for supported harnesses.

Agent Runtime

Give agents a working environment, then choose where it runs: a laptop, a remote machine, or cloud infrastructure.

  • Agent Lifecycle: Create, start, stop, and inspect agents through a common CLI. Attach to supported interactive sessions.
  • Runtime Choice: Run on Docker, Podman, Apple Container, Kubernetes, or Cloud Run.
  • Working Environment: Configure each agent's tools, environment, credentials, and workspace sharing.
  • Hosted Controls: Use roles, access boundaries, scoped secrets, and federated identity as the team grows.
Agent State Model Simulator
Dimension 1: Infrastructure Phase
provisioningrunningstoppingstopped
Dimension 2: Cognitive Activity
offlineworkingthinkingwaiting_for_inputblocked
Dimension 3: Detail Stream
Phase: provisioning
Activity: offline
Status log: Allocating container sandbox...
Click to trigger transitions

Agent Collaborators

Teams of humans and agents work toward a shared goal. Instructions guide how they delegate, exchange findings, and ask for help.

  • Adaptive Teams: Authorized agents use the scion CLI to create and manage collaborators as new tasks emerge.
  • Shared Conversations: Exchange messages, mentions, and attachments through web chat and connected chat services.
  • Human Participation: Answer questions, redirect work, or join an interactive harness session.
  • Visible Progress: Follow agent activity, inspect logs, and trace who delegated work to whom.
🧑‍💻👤🤖🤖🤖🤖🤖🤖🤖

Agent Notifications

Let work proceed asynchronously, with notifications that bring collaborators back when they are needed.

  • Progress Signals: Agents report when they are working, blocked, finished, or waiting for input.
  • Delegation: A parent can wait for a child task and continue when a notification arrives.
  • Subscriptions: Route completion, stall, and input requests to the collaborators who need them.
  • Human Attention: Surface requests for help through the web UI and configured chat integrations.
Reactive Notification Wakeup
🤖COORDINATOR🤖🤖🤖🤖🤖🤖

Shared Filesystem

Give agents a place to exchange code, research, and artifacts. Choose what they share and where they work independently.

  • Workspace Choice:
    • Use a shared workspace, separate Git worktrees, or independent clones to match the project.
  • Context by Reference:
    • Share artifact paths so collaborators can read what they need when they need it.
  • Shared Notes:
    • Keep findings, handoffs, and progress summaries in project shared directories.
  • Explicit Coordination:
    • Use team instructions to establish file ownership and coordinate overlapping edits.
Shared Filesystem Simulator
🤖Agent 1🤖Agent 2📁scion/📁src/📁tests/📄auth.py🔒📄server.py🔒📄test_auth.py🔒
Click "Run Simulation" to observe concurrent filesystem operations.

Scion Orchestration Review

Combine these building blocks to explore your own collaboration patterns, from a pair of specialists to a changing team.

1. Define

Give each agent a purpose with reusable instructions, skills, and tools.

2. Run

Choose a runtime and configure each agent's environment and credentials.

3. Spawn

Delegate to specialists and exchange findings as the work develops.

4. Notify

Bring collaborators back when tasks finish or an agent needs help.

5. Sync

Share artifacts and notes, with workspace boundaries chosen for the project.

Build the Team Your Project Needs

Open-source infrastructure for experimenting with collaboration and operating the patterns that prove useful.

Your Agents, Your Models

Combine the strengths of different harnesses and models in one team.

  • Harness choice — Claude Code, Gemini CLI, Codex, OpenCode, and more.
  • Extensible setup — configure provisioning and authentication through harness bundles.
  • Specialized roles — define responsibilities and tools through templates.

From Laptop to Hosted Team

Choose the infrastructure that fits the project and the people using it.

  • Start locally — use the CLI or a Workstation Hub with a web UI.
  • Host a team — single-node and HA deployment options.
  • Runtime choice — Docker, Podman, Apple Container, Kubernetes, and Cloud Run.

Stay in the Conversation

Delegate work and stay involved as agents exchange findings and ask for direction.

  • Native web chat — threads, mentions, attachments, and conversation export.
  • Connected channels — Telegram, Discord, Slack, Google Chat, and Microsoft Teams.
  • Human participation — receive requests for input or attach to supported agent sessions.

Make Expertise Reusable

Turn what works into templates and skills that other agents and teams can use.

  • Skill Bank — publish, version, discover, and resolve reusable skills.
  • Connected registries — bring skills from GitHub and external sources.
  • Project context — share artifacts, handoffs, and findings through shared directories.

See and Control the Work

Understand what agents are doing and set the boundaries for how they operate.

  • Observability — agent logs, session metrics, and system health.
  • Hosted access controls — roles, access boundaries, scoped secrets, and federated identity.
  • Deliberate sharing — choose shared workspaces or separate worktrees and clones.

Open to Your Ecosystem

Compose Scion with the tools and services your project needs.

  • Open interfaces — CLI, APIs, lifecycle hooks, MCP configuration, and an A2A bridge.
  • Your tools — connect task tracking, memory, and data systems.
  • Open source — Apache 2.0, with room to contribute new harnesses, skills, and collaboration patterns.

See It In Action

Explore how agents run, communicate, and collaborate in Scion.

Start with One Agent. Explore What a Team Can Do.

The Workstation onboarding wizard helps you choose a runtime, configure credentials, and create your first project.

1

Install

Use the community Homebrew tap.

brew install homebrew-scion/scion/scion
2

Set Up

Open the guided Workstation setup.

scion server start
3

Launch

Give an agent a concrete task.

scion start debug "Fix the bug"
4

Collaborate

Join the session and shape the next step.

scion attach debug

Help Shape How Agents Work Together

Scion is an active, pre-release open-source project. Try a collaboration pattern, share what you learn, and help improve the tools behind it.