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 uses a managed section so your own rules are preserved 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.