gutt-claude-code-plugin

gutt Plugin for Claude Code & Cursor

Persistent organizational memory for Claude Code and Cursor via gutt.

What is gutt?

gutt is persistent organizational memory for AI agents.

• Decisions — Who decided what, when, and why
• Lessons — What worked, what didn't, don't repeat mistakes
• Context — Projects, people, relationships, history

This plugin connects Claude Code to your gutt memory, automatically:

• 📥 Retrieves relevant context before every task
• 📤 Captures lessons after every task
• 🔄 Works with subagents — All agents get memory, automatically

Sign up for gutt →

---

Overview

This plugin provides a memory backbone for Claude Code, enabling:

• Automatic memory retrieval before every task
• Lesson capture prompts after significant work
• Auto-linting after file edits
• Multi-hop graph exploration for deep organizational insights

Quick Start

Via Marketplace (Recommended)

1. Install: claude plugin add gutt-claude-code-plugin@gutt-plugins
2. Setup: Run /gutt-claude-code-plugin:onboard
3. Done — memory integration is active

Manual Install (Developers)

1. Clone: git clone https://github.com/iBrain-BVBA/gutt-claude-code-plugin ~/.claude-plugins/gutt-claude-code-plugin
2. Enable: Add to .claude/settings.json under "plugins"
3. Setup: Run /gutt-claude-code-plugin:onboard

Cursor

Installation

1. In Cursor, run /add-plugin and enter the repo URL: https://github.com/iBrain-BVBA/gutt-claude-code-plugin
2. Run the setup command to configure the MCP connection
3. Enter your organization's gutt MCP endpoint URL when prompted
4. Restart Cursor → Settings → Tools & MCP Servers → Connect gutt-mcp-remote
5. Complete OAuth login

Cursor doesn't support all Claude Code hooks. 4 of 11 hooks are portable (prompt submit, file edit lint, pre-task memory, stop lessons). Missing automation is compensated by Cursor rules (.mdc) that guide memory-first workflows.

See docs/team-onboarding.md for detailed installation instructions for both IDEs.

Features

Statusline

Real-time gutt status in your Claude Code HUD:

• Connection status — Green circle when connected
• Memory stats — mem:X queries, lessons:X captured
• Toast notifications — Shows memory operations for 5 seconds

The statusline is auto-enabled on first session. Optional settings in ~/.claude/settings.json:

{
  "gutt": {
    "statusline": {
      "showTicker": true,
      "multiLine": true
    }
  }
}

Hooks

Note: Hooks can be registered in either hooks/hooks.json (plugin-level) or .claude/settings.json (project-level). The table below shows all available hooks.

Hook	Event	Purpose
session-start.cjs	SessionStart	Shows setup reminder if not configured
sessionstart-setup.cjs	SessionStart	Auto-enables HUD statusline on first run
user-prompt-submit.cjs	UserPromptSubmit	Reminds to search memory before tasks
stop-lessons.cjs	Stop	Prompts for lesson capture after work
post-tool-lint.cjs	PostToolUse	Auto-lints files after Edit/Write
pre-task-memory.cjs	PreToolUse	Injects memory context before subagents
post-task-lessons.cjs	PostToolUse	Captures lessons when subagents complete
post-memory-ops.cjs	PostToolUse	Tracks memory tool calls for statusline
subagent-start-memory.cjs	SubagentStart	Injects cached memory context into subagents
subagent-plan-review.cjs	SubagentStop	Suggests GUTT memory search after plans

Subagent Coverage: The pre-task-memory and post-task-lessons hooks ensure that ALL subagents get organizational context and contribute lessons back.

Skills

Skill	Command	Purpose
memory-retrieval	/gutt-claude-code-plugin:memory-retrieval	3-part memory search (facts, nodes, lessons)
memory-capture	/gutt-claude-code-plugin:memory-capture	Structured lesson capture with 4 patterns

Agents