OPERATIONAL COMMANDS

swamp audit

View an audit timeline of Swamp vs direct CLI commands.

swamp audit

Flag	Default	Description
--repo-dir <dir>	.	Repository directory (env: SWAMP_REPO_DIR)
--hours <n>	24	Number of hours to look back
--all		Show all commands including noise
--session <id>		Filter by session ID
--include-diagnostic		Include rows written by swamp doctor audit smoke test
--server		Run against a remote swamp serve instance
--token		Server token in <name>.<secret> format

---

swamp summarise

Show a high-level overview of repository activity — method executions, workflows, and data. Also available as swamp summarize.

swamp summarise

Flag	Default	Description
--repo-dir <dir>	.	Repository directory (env: SWAMP_REPO_DIR)
--since <dur>	7d	Look-back window (e.g., 1h, 1d, 7d, 1w)
--limit <n>		Cap per-group run details
--server		Run against a remote swamp serve instance
--token		Server token in <name>.<secret> format

---

swamp telemetry stats

View telemetry usage statistics.

swamp telemetry stats

Flag	Default	Description
--repo-dir <dir>	.	Repository directory (env: SWAMP_REPO_DIR)
--days <n>	2	Number of days to report

---

swamp source

Manage the local copy of Swamp source code used for troubleshooting.

swamp source fetch

Download Swamp source code from GitHub.

swamp source fetch

Flag	Description
--version <version>	Version to fetch (tag or main). Default: latest.

swamp source path

Show the Swamp source location and installed version.

swamp source path

No flags.

swamp source clean

Remove downloaded Swamp source.

swamp source clean

No flags.