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 |
The data directory
Section titled “The data directory”| 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.