A first-use guide for connecting and verifying gutt memory, a system that lets an agent search and store project knowledge. It also explains the HUD and active hooks, which are interface and automation features.

Setting up gutt memory, testing its connection, learning the basic search and capture flow, and troubleshooting missing or unreachable configuration.

It checks whether the memory server is configured and reachable before explaining how the integration works.

onboard — Skill for Claude Code and Codex by iBrain-BVBA: A first-use guide for connecting and verifying gutt memory…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add skills/ibrain-bvba/gutt-claude-code-plugin/onboard

Any agent

npx skills add iBrain-BVBA/gutt-claude-code-plugin --skill onboard

Clone the repo

git clone --depth 1 https://github.com/iBrain-BVBA/gutt-claude-code-plugin

Made for: Claude Code, Codex.

Or install gutt-pro, the plugin that ships this one along with the rest of its 11 skills, 10 commands, 2 agents, 5 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/ibrain-bvba/gutt-claude-code-plugin/onboard.svg)](https://agentmods.dev/skills/ibrain-bvba/gutt-claude-code-plugin/onboard)

Your own site

<a href="https://agentmods.dev/skills/ibrain-bvba/gutt-claude-code-plugin/onboard"><img src="https://agentmods.dev/badge/skills/ibrain-bvba/gutt-claude-code-plugin/onboard.svg" alt="Measured on agentmods" height="20"></a>

Per session 48 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,467 The whole file, excluding the scripts and references it only reads on demand.

Security scan B 1 finding. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00048	$0.01467
Opus 5	$0.00024	$0.00733
Sonnet 5	$0.00010	$0.00293
Haiku 4.5	$0.00005	$0.00147

Measured 5d ago against content hash 67485ed27a7d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

onboard scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

cat .claude/settings.json 2>/dev/null | grep -q "gutt"

gutt-core/skills/onboard/SKILL.md · 166 lines

How it starts

The opening of the file, as written. The whole thing — 166 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Onboard Skill

Announce: "Starting gutt memory onboarding..."

Walk the user through first-use setup and verification of the gutt memory integration.

Flow

Step 1: Detect MCP

Check if the gutt MCP server is configured in the project's settings.

# Check for gutt MCP configuration in settings
cat .claude/settings.json 2>/dev/null | grep -q "gutt"

If configured: Announce "gutt MCP server found in settings." and proceed to Step 2.
If NOT configured: Ask the user for their MCP server URL and guide them through setup:
1. Ask: "What is your gutt MCP server URL? (e.g., https://your-instance.gutt.io/mcp)"
2. Explain they can also run /gutt-pro:setup to configure it.
3. Once URL is provided, help add it to .claude/settings.json.

Step 2: Verify Connectivity

Run a test query to confirm the MCP connection is live:

search_memory_nodes(query="test connectivity", max_nodes=1)

Result	Action
Success (any response)	"MCP connection verified." Proceed to Step 3.
Not configured error	"MCP server not configured. Run `/gutt-pro:setup` first." Stop.
Unreachable / timeout	"MCP server unreachable. Check your network and server URL." Stop.
Auth failure	"Authentication failed. Check your API key or token." Stop.

Step 3: First Search

Demonstrate memory retrieval by searching the knowledge graph:

search_memory_nodes(query="recent decisions or lessons", max_nodes=5)

Show results formatted as:

## Your Memory Graph

Found [N] entries:

| Entity | Type   | Summary         |
| ------ | ------ | --------------- |
| [name] | [type] | [brief summary] |

Explain: "The gutt memory graph stores organizational knowledge -- lessons learned, decisions made, patterns discovered, and relationships between them. Every search, capture, and agent delegation flows through this graph."

Read the full file on GitHub · 166 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

5d ago First seen · 166 lines · 48 tokens per session scan B 67485ed27a7d

Subscribe to this mod's changes

onboard is a skill published in the GitHub repository iBrain-BVBA/gutt-claude-code-plugin (5 stars, last pushed 2d ago), licensed MIT. It adds 48 tokens to every session and 1,467 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Memory and context

media-ingest

Ingest video, audio, PDF, book, screenshot, and GitHub repo content into the brain. Multi-format handling with entity extraction and backlink propagation. Covers video-ingest, youtube-ingest, and book-ingest subtypes.

garrytan/gbrain · 52 tokens

mem0-oss-to-platform

Plan and then execute a migration of a project from the mem0 open-source / self-hosted SDK (the local Memory class) to the mem0 Platform / hosted / managed SDK (the MemoryClient class). Use this whenever a developer wants to move, switch, or migrate their mem0 usage off OSS/self-hosted to the hosted API — e.g.…

mem0ai/mem0 · 273 tokens

Cortex

Operate Cortex, the LifeOS memory system — the typed Knowledge Archive (People, Companies, Ideas, Research with typed related: links) plus recall of prior work sessions, ISAs, and conversations. Search, add, harvest, develop, ingest, distill, graph-navigate, recall. USE WHEN cortex, knowledge, knowledge base, search…

danielmiessler/LifeOS · 196 tokens

agent-memory

../../../engineering/agent-memory/skills/agent-memory/SKILL.md.

alirezarezvani/claude-skills · 0 tokens

memory

Use when the user asks to remember, recall, forget, update, search, or inspect durable OpenSquilla memory, including profile facts in USER.md and long-term notes in MEMORY.md or memory//.md.

opensquilla/opensquilla · 44 tokens

ha-data-stores

Map of Hope Agent's local data stores and safe read-only query workflow. Use when the user asks where Hope Agent stores data, wants to inspect sessions/messages/memory/logs/background jobs/knowledge indexes/settings, asks the model to query local app data, or debugging requires checking persisted state. Trigger…

shiwenwen/hope-agent · 115 tokens

onboard