Swamp
A CLI that teaches AI coding agents to break problems into reusable behaviors and connect them into reviewable, repeatable workflows.
At a Glance
Swamp CLI licensed under AGPL v3 with an extension and definition exception. Requires a free Swamp Club account to run.
Engagement
Available On
Listed Nov 2026
About Swamp
Swamp is a command-line tool from Elder Swamp Club, Inc. that guides an AI coding agent to turn a task into reusable behaviors and workflows. Those workflows can be reviewed in a Git repository, shared and run again. Runtime data is kept by default in a local .swamp/ directory.
What It Is
Swamp is a CLI for building automation with AI agents from repeatable pieces instead of one-off agent runs. You describe what you want, such as auditing DNS records or inventorying EC2 instances, and the agent creates behaviors, wires them into workflows and runs them. The results are reviewable in the repo before anything touches production.
Core Building Blocks
- Behaviors: reusable units defined as YAML files, with CEL expressions for dynamic values. Custom behaviors can be written in TypeScript.
- Workflows: ordered sequences of behaviors, run across parallel jobs with dependency ordering and trigger conditions.
- Extensions: integrations with APIs, databases and services, pulled from a registry or written yourself.
- Vaults: credential storage that injects secrets only when needed and redacts them from output.
- Datastore: versioned, immutable data from every method run, stored locally, on an external filesystem or in S3 via an extension.
Working with AI Agents
Swamp bundles skills for Claude Code, Cursor, OpenCode, Codex, Kiro, Amp, Copilot CLI, Pi and Antigravity. swamp repo init --tool <name> writes the skills and instruction files into the agent's directory. swamp start opens a browser flow to pick a workspace, describe a task and launch a detected agent in a new terminal.
Setup and Operations
Swamp runs locally on macOS, Linux and Windows and uses environment credentials from your shell. A Swamp Club account is required to run it. It supports OpenTelemetry traces and logs, anonymous telemetry that can be disabled, shell completions, and a SWAMP_HOME setting for relocating its files. It is licensed under AGPLv3 with an extension and definition exception, and external pull requests are not accepted; contributions go through issues.
Community Discussions
Be the first to start a conversation about Swamp
Share your experience with Swamp, ask questions, or help others learn from your insights.
Pricing
Swamp CLI (self-hosted, AGPLv3)
Swamp CLI licensed under AGPL v3 with an extension and definition exception. Requires a free Swamp Club account to run.
- Licensed under GNU Affero General Public License v3.0 with the Swamp Extension and Definition Exception
- Works with Claude Code, Cursor, Codex, OpenCode, Kiro and more
- Runs on macOS, Linux (x86_64 and arm64) and Windows (x86_64)
- Requires a Swamp Club account to run
- Trademarks not licensed outside the trademark policy
Capabilities
Key Features
- Reusable behaviors defined in YAML with CEL expressions
- Workflows with parallel jobs, dependency ordering and trigger conditions
- Extension registry for API, database and service integrations
- Vaults that inject secrets only when needed and redact them from output
- Versioned datastore with local, filesystem and S3 backends
- Bundled skills for nine AI coding tools
- Recorded runs for every execution
- OpenTelemetry tracing and log export
- Shell completions for Bash, Zsh, Fish and PowerShell
- Self-update via swamp update
