Swampcastle

SwampCastle Claude Code Plugin

A Claude Code plugin that gives your AI a persistent memory system. Mine projects and conversations into a searchable palace backed by Lance by default, with 19 MCP tools, auto-save hooks, and 5 guided skills.

Prerequisites

• Python 3.11+

Installation

Claude Code Marketplace

claude plugin marketplace add dekoza/swampcastle
claude plugin install --scope user swampcastle

Local Clone

claude plugin add /path/to/swampcastle

Post-Install Setup

After installing the plugin, the first CLI run creates default runtime config automatically. To prepare a project for mining, run:

/swampcastle:init

To change global backend or storage settings later, run:

swampcastle wizard

Available Slash Commands

Command	Description
/swampcastle:help	Show available tools, skills, and architecture
/swampcastle:init	Set up SwampCastle -- install, configure MCP, onboard
/swampcastle:search	Search your memories across the palace
/swampcastle:mine	Mine projects and conversations into the palace
/swampcastle:status	Show palace overview -- wings, rooms, drawer counts

Hooks

SwampCastle registers two hooks that run automatically:

• Stop -- Saves conversation context every 15 messages.
• PreCompact -- Preserves important memories before context compaction.

Set the MEMPAL_DIR environment variable to a directory path to automatically run swampcastle mine on that directory during each save trigger.

MCP Server

The plugin can configure a local MCP server with 19 tools for storing, searching, and managing memories. Use /swampcastle:init for guided project setup and MCP guidance.

Full Documentation

See the main README for complete documentation, architecture details, and advanced usage.