USE SWAMP WITH KIRO

Prerequisites

• Swamp installed
• Kiro installed (IDE or CLI)

Initialize the repository

$ swamp repo init --tool kiro

You will see output like:

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

What this sets up

Swamp creates a steering file with its rules, copies bundled skills to .kiro/skills/, and configures both the IDE and CLI. The IDE gets trusted command permissions and an audit hook. The CLI gets an agent configuration at .kiro/agents/swamp.json that declares skill resources and trusted commands. These are dedicated files that swamp owns and overwrites on upgrade.

Verify it works

In Kiro IDE, select swamp-getting-started from the / skills menu.

In kiro-cli, type:

I am new to swamp

The agent matches 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 steering file, agent config, and hooks are overwritten with the latest versions. VS Code settings are merged to preserve any trusted commands you added.