Sessions & Agents
In CrewHub, a session is a single running instance of an AI agent. Each session has a type, status, and activity — and is represented by a bot in the 3D world.
Session Types
CrewHub assigns a visual type to each session based on how it was connected. The type determines the bot's color and 3D model in the world — it doesn't dictate what the agent does, that's entirely up to you.
| Source | Color | When assigned |
|---|---|---|
| Claude Code | ● Orange | Sessions detected from ~/.claude/projects/ |
| OpenClaw | ● Blue | Sessions from an OpenClaw gateway connection |
| Sub-agent | ● Green | Child sessions spawned by a parent agent |
| Custom | ● Any | Manually configured connections — color customizable |
Agent names, roles, and colors are yours to define. CrewHub doesn't enforce any team structure — use whatever naming fits your workflow. You can rename any session and assign it a custom display name in the session detail panel.
Session Status
Each session has a real-time status:
- Active — currently processing a request or streaming a response
- Idle — connected and waiting for input
- Working — running tool calls (reading files, executing commands)
- Meeting — participating in an AI meeting
- Supervising — managing sub-agents or waiting for sub-tasks
- Offline — session has ended or connection lost
Cards View
The Cards view is the default dashboard layout. Each card shows:
- Agent name and type badge
- Current status with color indicator
- What the agent is doing right now (e.g., "Reading config.py")
- Token count and cost for the session
- Duration since session started
Use the filter bar at the top to filter by status, type, or room.
Session Detail Panel
Click any session card to open the full detail panel:
- Chat history — full conversation including tool calls
- Activity feed — timestamped log of every action
- Stats — tokens, cost, messages, runtime
- Actions — send a message, start a meeting, hand off to terminal
Sub-agents
When a main agent spawns a sub-agent (e.g., Claude Code spawning a specialized task), the sub-agent appears as a child session. In the 3D world, sub-agents spawn near their parent bot. In the cards view, they're shown with an indented "sub-agent" indicator.
Sub-agent responses are surfaced in the parent session's chat — you can see the full result without switching sessions.
Session Lifecycle
Sessions stay visible in CrewHub even after they end, so you can review what was done. Sessions that have been inactive for more than 30 minutes are moved to the Parking area in the 3D world and collapsed in the cards view.