Skip to main content

INSTALL SWAMP

This guide shows you how to install the Swamp CLI on macOS or Linux and verify it works.

Install the CLI

Open your terminal and run:

$ curl -fsSL https://swamp-club.com/install.sh | sh

Verify the installation

Run:

$ swamp version

You should see output like:

2026-07-27T23:29:40.649Z [INF] version: swamp "20260727.150514.0-sha...."

Fix "command not found"

If your shell cannot find swamp, restart it:

$ exec $SHELL

If the command is still not found, add ~/.local/bin to your PATH. Add one of these lines to your shell profile (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish):

# bash / zsh
export PATH="$HOME/.local/bin:$PATH"

# fish
fish_add_path ~/.local/bin

Then restart your shell and run swamp version again.

Next steps

  • Build your first automation — a guided tutorial from a fresh install to a working health-check workflow
  • If you work with an AI agent, initialize a repository with swamp repo init (per-agent setup), then ask your agent to "get started with Swamp" — the swamp-getting-started skill walks you through building a first model around your own goal
  • Set up shell completions for tab completion of subcommands, flags, and model names
  • Set up background autoupdating to keep the CLI current without manual intervention
← PreviousRemote ExecutionNext →Collaborate in the Swamp