AgentHub

Use when you need to interact with the AgentHub Controller — create tasks, create workers, check status, send heartbeat.

Use when inspecting, registering, summarizing, or handing off task artifacts.

Use when deciding whether existing Workers can handle a goal or whether a new Worker/team should be proposed.

Use when you need to manage Matrix rooms, send messages, or handle room participants.

Use when a Worker, RuntimeLease, Matrix binding, task, or artifact pipeline is stale, failed, or blocked.

Use when managing shared task files and artifact storage. Coordinate file handoffs between workers via shared storage.

Use when delegating git operations to Workers — commits, branches, PRs. The Manager does not execute git directly.

Use during Manager patrol to inspect room bindings, Worker health, RuntimeLeases, and active tasks.

Use when discovering available workers or checking if a suitable worker exists for a task.

Use when managing human users — creating accounts, setting permissions, managing access to teams and workers.

Use when configuring MCP Server tools for Workers. MCP Servers provide external API access through a standardized protocol.

Use when recording durable lessons about rooms, Workers, tasks, failures, or human preferences.

Use when switching the Manager's own LLM model or checking the current model configuration.

Use when managing multi-worker projects with phases, dependencies, and shared deliverables.

Use when assigned work has produced visible results and the Manager must verify evidence, synthesize outcomes, and report final delivery.

Use when exposing Worker services (web servers, APIs) to external access.

Use when coordinating multiple concurrent tasks — tracking processing markers, managing task dependencies, and handling concurrent execution.

Use when you need to create runs, assign tasks to workers, or manage task lifecycle.

Use when you need to create, manage, or dissolve teams of workers. Teams group workers under a leader for complex multi-worker projects.

Use when you need to create, inspect, wake, sleep, stop, or update Worker agents.

Use when switching a Worker's LLM model.

Sync files with shared storage. Use when your coordinator or another Worker notifies you of file updates (config changes, task files, shared data, collaboration artifacts).

Use when executing a task (progress logging, plan updates), when resuming a task after session reset, or when managing task history. Covers progress log format, task-history.json, and resume flow.