Plugin Documentation
Claude Code Plugin
Connect Claude Code to gutt for persistent organizational memory across all your AI coding sessions.
Quick Start
1. Add the marketplace
/plugin marketplace add iBrain-BVBA/gutt-claude-code-plugin
2. Install the plugin
/plugin install gutt-claude-code-plugin@gutt-plugins
3. Run the setup wizard
/gutt-claude-code-plugin:setup
The wizard will configure your gutt MCP endpoint and authenticate your session.
4. Restart Claude Code
Press Ctrl+C and run claude again to activate the plugin.
What's Included
The plugin ships with 10 production-ready hooks that automatically integrate gutt into your workflow:
| Hook | What It Does |
|---|---|
| session-start | Auto-fetches relevant organizational context |
| user-prompt-submit | Reminds to check memory before starting work |
| stop-lessons | Prompts lesson capture after significant work |
| post-tool-lint | Auto-lints files after Edit/Write operations |
| pre-task-memory | Injects memory context before subagents |
| post-task-lessons | Captures lessons when subagents complete |
| subagent-start-memory | Injects cached memory into subagents |
| subagent-plan-review | Suggests memory search after plans |
| post-memory-ops | Tracks memory tool calls for statusline |
| statusline | Shows gutt connection status in HUD |
Skills & Agents
Skills
/gutt-claude-code-plugin:memory-retrieval3-part memory search: facts, nodes, and lessons
/gutt-claude-code-plugin:memory-captureStructured lesson capture with 4 patterns
Agents
gutt-pro-memoryMulti-hop graph exploration and advanced search strategies
memory-keeperAutonomous lesson capture after significant work
config-discoveryScan repos for Claude Code config drift
Memory Capture Patterns
When capturing lessons, use one of these patterns for best results:
Negation
"X does NOT work because Y"
Replacement
"Instead of X, use Y"
Decision
"We decided X because Y"
Lesson
"Learned that X when Y"
Troubleshooting
Hook not firing
- Verify plugin is installed: run
/plugins - Verify Node.js is in PATH
- Restart Claude Code to reload hooks
MCP connection failed
- Run
/mcp, select gutt-mcp-remote, choose "Authenticate" - Check network connectivity to your MCP endpoint
- Contact your organization admin if authentication fails
Memory search returns no results
- Verify OAuth authentication completed successfully
- Try broader search terms
- Check if memory has been populated for your organization