Skip to content

Swarmed's tools for agents

Every session gets an MCP server named swarmed, with these tools:

Tool What it does
show_html shows HTML in the conversation, in a sandboxed frame
list_sessions, read_session see and read the other open sessions of the same project
send_message write to another session; queued if it is busy
spawn_session, close_session start a session in the same task, up to six, and close the idle ones it started
delegate_to_cloud hand work to a Codex cloud agent or a Claude Code cloud session
use_skill read a skill Swarmed offers
set_mark put a colour and a few words on its own session in the sidebar
configure change Swarmed’s own settings, within limits

Claude Code may call show_html without asking; in Ask mode you are asked about the rest. Other agents decide for themselves which calls they ask about.

An agent can answer with HTML, such as a chart, a table or a mock-up. Swarmed shows it in the conversation in a sandboxed frame on an origin of its own, under a policy that lets it make no request. A link pressed in a view is shown with its address and opened only when you say so. html_views in the settings turns views off.

Work goes to a cloud agent through your own codex or claude, which works on the repository as GitHub has it: it does not see what is only on your Mac, and it needs neither Swarmed nor your Mac to keep working.

From a session there are two ways to tell it what the session arrived at: a brief the session’s agent writes and hands over with delegate_to_cloud, in the conversation, where you see it; or the conversation itself, what was said and the plans the agent proposed, as text under what to do. swarmed cloud does the same from a terminal.

configure makes some changes at once, and can only propose others: the change is shown in the conversation and made when you accept it.

Done at once saved prompts, actions that send a prompt, the status line’s pieces, the looks, the terminal’s settings, and removing an action, a prompt or the status line’s script
Only proposed adding a rule, saving an environment, an action that runs a command, a status line script
Out of reach API keys, MCP servers, sign-ins, supervision and notes

It tells an agent the names of an environment’s variables, never their values.