Skip to main content

Departments

As your agents multiply, a flat list stops telling the story. Departments give your agents a real org structure — Marketing, Engineering, Support — with named levels inside each, and the platform wires the team up from it: who can delegate to whom, who a department head's briefing covers, and how the whole company is drawn on the Agents page.

Structure: departments and levels​

A department is a named group of agents with ordered levels. The create form suggests Head / Senior / Junior, and you can rename them or add your own, up to eight. Each agent is assigned a department and level in its settings (Agent Settings → Configuration → Department).

Levels aren't just labels. They drive automatic delegation: each department has a delegation mode that decides which of its agents can hand work to which, shown as a small diagram on the department's card:

  • Off connects no one, so the department is purely organizational.
  • Down only (the default for a new department) is a strict hierarchy. Each level can delegate to the level below it and nothing else, so a head reaches its team, but team members can't reach the head or each other.
  • Down and across works the same way, and agents on the same level can also delegate to each other.
  • All directions lets each level delegate both up and down, and agents on the same level delegate to each other. A manager can hand work down, and a junior can delegate or hand files back up.

Departments created before delegation modes existed keep the connections they already had: they show as All directions, or as Off if automatic delegation was switched off.

A second setting, the reach, decides how far those connections go. One level up or down (the default) connects each level only to the level directly above or below it. Whole department connects every level, however far apart. For example, a Down only department with the whole department as its reach lets the head delegate to every level below it, while still letting no one delegate upward. With one level up or down, nothing carries over: the top level doesn't automatically reach two levels down.

In a chat, an agent can see the work of every agent you have access to, but it can still delegate only to the agents it's connected to. When one of the agent's own shared tasks runs on a schedule, with no person behind it, the connections also decide what it can see: it reads the shared activity of the agents it's connected to and nothing else. So in an All directions department a team member's scheduled runs also see the level above them, while in a downward mode the head sees its team and the team sees no one through the department.

Auto-wired links are marked in each agent's Delegation Targets roster ("via Department") and cleanly retract if the agent leaves the department — delegation targets you checked by hand are never touched. Every agent's system prompt states its department, level, and reachable teammates, so agents know their own place in the structure.

The company map​

The Agents page shows all of this as a live 3D company map: each department stands on its own base in a night-time meadow, its agents arranged into an amphitheater by level, with the head row closest so rank reads at a glance. A glowing border shows each agent's 7-day activity heat, and a pulse means the agent is responding right now. Delegation links are drawn between agents, so what you see matches who can actually hand work to whom.

Navigation is zooming: zoom out to see the whole company, swipe (or use the bottom selector, or the arrow keys on desktop) to move between departments, zoom in to step inside one. The map opens on your favorite agent's department. Clicking an agent opens its chat, and the ⋯ menu carries favorites, delegation links, department moves, and creating or installing agents.

Prefer lists? The Grid view groups agents by department with each card carrying its level badge, and the Departments tab lists every department as an expandable card. The map/grid choice follows you across devices, and the grid is the automatic fallback where 3D isn't available.

Who manages departments​

  • Admins manage all departments, and creators manage the ones they created.
  • Assigning an agent to a department needs manager access on that agent plus a platform admin or creator role.
  • Everyone else sees the departments they're part of. An agent you can't access shows grayed out on the map.

Departments pair naturally with agent-scope scheduled briefings: a department head agent's morning task can read what its team's agents did overnight (their shared tasks, sessions, and notifications) and summarize it. See Delegation.

Next steps​