Agent Runner

Multiple Agents Orchestration for VS Code

Agent Runner adds a local multi-agent workspace to VS Code and code-server. Use it to chat with a manager agent, route messages to specific agents, inspect agent state, and schedule follow-up work.

Usage

Open the Activity Bar:

• AGENT RUNNER CHAT opens CHATROOM.
• AGENT RUNNER opens AGENTS, AGENDA, and OUTPUT.

Chatroom

Use CHATROOM as the main user-agent message center.

• Type a normal message to send it to manager.
• Use @agent mentions to route directly to specific agents, for example @architect review this design.
• Mention multiple agents to send one copy to each target, for example @architect @backend compare the implementation options.
• Pick a WorkDir from the project dropdown before sending a project-specific message.
• Use reload to refresh chat history and rebuild the project list.

Agents

Use AGENTS to inspect and control local agents.

• Expand an agent to see its first-level Markdown files.
• Click an agent to switch OUTPUT to that agent.
• Use the inline screen button to open the agent screen session.
• Use the inline restart button to restart one agent.
• Open the config button to edit ~/.agent-runner/agents/config.

The manager agent is always shown first. Other configured agents appear below it.

Agenda

Use AGENDA to inspect scheduled work.

• ONE-TIME shows pending delayed tasks.
• REPEATED shows repeating tasks.
• DISPATCHED shows the latest dispatched tasks.
• Use Process Due Agenda Now to process due work immediately.

Agents schedule delayed or repeated work through Agent Runner; scheduled tasks are delivered back into the target agent inbox when due.

Output

Use OUTPUT to read the selected agent screen log. The default output is the manager log.

Runtime Files

Agent Runner stores runtime state under:

~/.agent-runner

Important folders:

• agents/: agent config and per-agent working folders
• mailbox/: per-agent inbox and processed messages
• chatbox/: chat history and chat endpoint state
• agenda/: scheduled work state
• projects/: WorkDir-specific shared project knowledge