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.
HTML views
Section titled “HTML views”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.
Handing work to the cloud
Section titled “Handing work to the cloud”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.
What configure may change
Section titled “What configure may change”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.