USE SWAMP WITH CURSOR

Prerequisites

• Swamp installed
• Cursor installed

Initialize the repository

$ swamp repo init --tool cursor

You will see output like:

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

What this sets up

Swamp creates a rules file with its instructions, copies bundled skills to .cursor/skills/ where Cursor auto-discovers them, and adds audit hooks that track command usage. The rules file and skills are dedicated files that swamp owns and overwrites on upgrade.

Verify it works

Open Cursor 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 configuration:

$ swamp repo upgrade

The rules file is overwritten with the latest version. Hooks are merged to preserve any entries you added.