Skip to content

Files and folders

Swarmed writes nothing into your repository beyond the tasks’ branches. Everything else is in two places:

What Where
Configuration and state ~/Library/Application Support/swarmed, or SWARMED_DATA_DIR
Worktrees ~/swarmed/<project>/<task>, or under SWARMED_WORKTREES_DIR
File Holds
swarmed.db projects, tasks, sessions and everything said in them (SQLite)
settings.toml the settings, the rules every agent is given among them
projects/<project>.toml a project’s configuration
projects/<project>.environments.toml its environments, readable by you alone
agents.toml, mcp.toml, skills.toml agents, MCP servers and hidden skills: see Coding agents and MCP servers and skills
actions.toml, projects/<project>.actions.toml actions for every repository, and for one
templates.toml saved prompts
layout.json, terminal.json the custom layout and the terminal
skills/ skills of Swarmed’s own
notes/ notes on projects and tasks, readable by you alone
snapshots/ snapshots, readable by you alone
spool/ HTML views agents hand over through Swarmed’s show_html tool
run/ stacks’ logs and what Swarmed is running

The app and the swarmed command write these. The TOML and JSON files may be edited by hand as well.