Multi-agent Galaxies

Share a Galaxy across multiple agents with RBAC, protocol overrides, and Gravity Bridges.

Multiple agents can share a single Galaxy. Each agent gets its own persistent identity and expertise profile while sharing the same Planets, Biomes, and knowledge.

How it works

Each agent orients with a unique agent_name:

{"tool": "brain.orient", "arguments": {"agent_name": "claude-code-main", "model": "claude-sonnet-4-6"}}
{"tool": "brain.orient", "arguments": {"agent_name": "cursor-agent", "model": "gpt-4o"}}

Both agents see the same knowledge. Each accumulates its own expertise profile, session history, and calibration scores. When one agent writes knowledge, the other can retrieve it immediately.

Access control

Orion uses role-based access control to scope what each user or agent can access:

Role	Planets	Write	Admin	Use case
owner	All	✓	✓	Galaxy creator
admin	All	✓	✓	Team leads
member	Assigned	✓	✗	Domain contributors
viewer	Assigned	✗	✗	Read-only consumers

Invite users via the API:

curl -X POST http://localhost:8000/api/v1/galaxy/invite \
  -H "Content-Type: application/json" \
  -d '{"planet_id": "p-123", "role": "member"}'

Returns a 7-day single-use invite token.

Per-Planet protocol overrides

Each Planet can override the Sun's agent_protocol for domain-specific rules. When an agent orients in that Planet, the override merges with the Sun defaults — Planet rules take precedence.

{
  "write_rules": ["Always cite legal precedent", "Mark as advisory only"],
  "require_reasoning": true,
  "forbidden_planets": ["HR", "Finance"]
}

This is useful when different domains have different compliance or quality requirements.

Gravity Bridges

Gravity Bridges connect Planets, enabling cross-domain knowledge flow. When a bridge exists between Engineering and Research, a search in Engineering can surface relevant records from Research.

Bridges are created automatically during Galaxy Merge and can be created manually via the API. RBAC still applies — users need access to both Planets to traverse a bridge.