USE SWAMP WITH CLAUDE CODE

Prerequisites

• Swamp installed
• Claude Code installed

Initialize the repository

Claude Code is the default tool, so no --tool flag is needed.

$ swamp repo init

You will see output like:

20:46:54.282 INF repo·init Initialized swamp repository at "/path/to/your/repo" (tool: "claude")

What this sets up

Swamp adds its rules and skill list to CLAUDE.md, bundled skills to .claude/skills/, and permissions for swamp CLI commands. Your own project instructions coexist in CLAUDE.md via managed sections — swamp only touches its own delimited block.

Verify it works

Open Claude Code in your repository and run:

/swamp-getting-started

The agent loads the getting-started skill and walks you through creating your first model.

Upgrading

When a new version of swamp is released, upgrade the repository to get updated skills and instructions:

$ swamp repo upgrade

The managed section in CLAUDE.md is replaced with the latest content. Anything you wrote outside the managed section is preserved.