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.

Use alongside another agent

Enroll multiple tools by repeating --tool on swamp repo init. Each tool's scaffolding is written independently, so .cursor/ and another tool's files (such as CLAUDE.md and .claude/) coexist in the same repository.

$ swamp repo init --tool cursor --tool claude

To enroll an additional tool in an existing repository, run swamp repo upgrade with the full intended list — upgrade replaces the enrolled tools, so any tool you want to keep must appear in the command:

$ swamp repo upgrade --tool cursor --tool claude

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.