Install GNO

Claude Code integration

Use GNO with Claude Code via the SKILL.md install or the MCP server.

Claude Code supports two integration paths. Skills install GNO as a /gno slash command. Tool definitions load only when the command is invoked. MCP exposes the same retrieval tools through the Model Context Protocol so Claude can call them automatically.

Quickstart

bun install -g @gmickel/gno
gno setup ~/notes --name notes

# Install the skill (preferred — zero context overhead)
gno skill install --target claude --scope user

# Optional: also install MCP for automatic tool calls
gno mcp install --target claude-code

gno setup returns only after lexical search proves a real result from the folder you just indexed, so a successful exit means retrieval works rather than that files were copied. Semantic embeddings continue independently in the background. You can also do both steps at once with gno setup ~/notes --name notes --connector claude-code-skill.

The skill target is called claude (Claude Code is the default). Use --scope user to install globally, or omit it for project-local install.

Using the skill

After installing the skill, Claude Code exposes a slash command:

/gno search "authentication patterns"
/gno query "how does our API handle errors"
/gno ask "what's our deployment process"

Skills are preferred for coding agents because they have zero context window overhead — the tool definitions only load when the slash command is invoked. Use gno skill install --target all to install across Claude Code, Codex, OpenCode, OpenClaw, and Hermes Agent at once.

Using MCP

With MCP installed, Claude Code can call gno_query / gno_search without a slash command. Example:

“Search my notes for deployment procedures”
“Find my architecture docs and summarize the relevant parts for this change”

Claude picks the right tool (gno_query, gno_search, etc.) based on the request.

Which one should you install?

WantInstall
Lowest context overhead, explicit lookupsSkill
Claude decides when to retrieve, without being askedMCP
Context Capsules, Knowledge Delta, and verified Ask as structured toolsMCP
Both, which is the common setupBoth — they do not conflict

Project scope

For project-specific knowledge, install at the project scope. This writes a .claude/settings.json in the current project instead of the user-level config.

gno mcp install --target claude-code --scope project

Pair this with a committed project profile so the repository declares what should be indexed and everyone who clones it gets the same retrieval setup.

Context Capsules from Claude Code

Ask Claude to compile one Context Capsule for a goal, reason only from that evidence, and cite evidenceId values. You get a bounded, auditable payload instead of five searches filling the window.

“Build a Context Capsule for why we dropped the queue rewrite, then answer only from its evidence and tell me if coverage is incomplete.”

The bundled skill recipes encode this and related workflows. Preview one with gno skill show --file recipes/brain-first-lookup.md.

Verifying and troubleshooting