team-harness

Coordinator Tools

On every turn the coordinator sends its full toolset to the model and dispatches whatever the model calls by name through the tool registry. The coordinator uses these tools to delegate and to inspect the workspace — it does not implement changes itself; that is the workers' job.

Agent management

Spawn and manage worker subprocesses.

ToolPurpose
spawn_agentStart a worker of a given agent type on a task
kill_agentTerminate a running worker
agent_statusInspect one worker's state
list_agentsList all workers and their states
wait_for_agentsBlock until specified workers finish
wait_for_anyReturn as soon as any specified worker finishes
read_agent_outputRead a worker's output so far
read_new_agent_outputRead only worker output produced since the last read

spawn_agent accepts the agent type, the task prompt, and optional overrides such as model, flags, and a worker_label. Every configured agent type — built-in or custom — appears automatically as a spawnable type (see Workers).

File system

Read and edit files. Paths may be relative or absolute — the file tools are not sandboxed to the working directory; access is limited only by the harness process's own permissions (see the trust model).

ToolPurpose
read_fileRead a file (also used to read skill instructions)
write_fileWrite a new file or overwrite an existing one
append_fileAppend to a file
edit_fileReplace a string in a file
multi_edit_fileApply multiple edits to one file
lsList a directory
globMatch files by glob pattern
grepSearch file contents
read_new_file_contentRead content produced since a prior read

Shell

ToolPurpose
bashRun a shell command (unsandboxed, stdin=/dev/null)

Task tracking

ToolPurpose
todo_writeWrite / update the persistent task list
todo_readRead the current task list

The task list is persisted per run as todo.json — see Run Logs.