# Install
bun install -g @gmickel/gno
# macOS: Vector search requires Homebrew SQLite
brew install sqlite3
# Initialize with your notes folder
gno init ~/notes --name notes
# Index documents (BM25 + vectors)
gno index
# Search
gno query "authentication best practices"
gno ask "summarize the API discussion" --answerYour Local Second Brain
Index everything. Search from CLI or Claude. Your data never leaves your machine.
Index your entire digital life—notes, code, PDFs, and Office docs. Turn your fragmented data into a cohesive local knowledge engine. Built for humans and AI agents alike, fully local and private.
Quick Start
What's New in v0.13
Knowledge Graph
Interactive force-directed visualization. See wiki links, markdown links, and similarity edges as a navigable constellation.
Learn more →Document Viewer
Enhanced reading with outgoing links, backlinks, and AI-powered related notes sidebar.
Learn more →Note Linking
Wiki-style [[links]], backlinks, and semantic similarity
for connected knowledge.
See It In Action
Quick Start
Initialize, index, and search in seconds
Search Modes
BM25, vector, and hybrid search comparison
Hybrid Search
BM25 full-text + vector similarity with reciprocal rank fusion for accurate results.
AI Answers
Get grounded responses with citations. Run locally or offload to a GPU server on your network.
Multi-Format
Index Markdown, PDF, DOCX, XLSX, PPTX, and plain text documents seamlessly.
Privacy First
All processing happens locally. Your documents never leave your machine.
Agent Integration
SKILL.md integration for Claude Code, Codex, and more. Zero context pollution, on-demand retrieval.
MCP Integration
Use as an MCP server for seamless AI assistant access to your knowledge base.
Fine-Tuned Models
Use the published slim retrieval model from Hugging Face or train and ship your own portable GGUF.
Web UI
Visual dashboard for search, browse, and AI Q&A. Switch presets and download models live.
REST API
HTTP API for programmatic access. Build custom tools and integrations in any language.
Tag System
Classify and filter with hierarchical tags. Auto-extract from frontmatter, filter with AND/OR.
Note Linking
Wiki links, backlinks, and semantic similarity. Navigate your knowledge graph.
Knowledge Graph
Interactive visualization of document connections. Explore wiki links, markdown links, and similarity edges.
Collections
Organize documents by source directory with contexts for improved relevance.
Fast CLI
Bun-powered for instant startup. Search thousands of documents in milliseconds.
Advanced Retrieval
Query expansion, metadata filtering, and cross-encoder reranking. Fully offline.
Why GNO?
Most search tools are either fast but dumb (grep, find) or smart but slow and cloud-dependent. GNO bridges this gap by running a full hybrid search pipeline (keyword, vector, and re-ranking) entirely on your local machine.
For AI Agents
Give your local LLM agents a long-term memory. GNO integrates as a Claude Code skill or MCP server, allowing agents to search, read, and cite your local files.
Claude Code
Install GNO as a skill and search your knowledge base directly from Claude Code:
gno skill install --scope user
MCP Clients
Connect GNO to Claude Desktop, Cursor, Raycast, and more:
gno mcp install # Claude Desktop (default)
gno mcp install --target cursor # Cursor
gno mcp install --target zed # Zed
gno mcp install --target windsurf # Windsurf
# ... and 6 more targets
Once connected, ask things like:
“Search my local notes for the project roadmap and summarize the Q4 goals.”
For Builders
Embed GNO directly inside another Bun or TypeScript app with the SDK.
import { createDefaultConfig, createGnoClient } from "@gmickel/gno";
const config = createDefaultConfig();
config.collections = [
{
name: "notes",
path: "/Users/me/notes",
pattern: "**/*",
include: [],
exclude: [],
},
];
const client = await createGnoClient({ config, dbPath: "/tmp/gno-sdk.sqlite" });
await client.index({ noEmbed: true });
const results = await client.search("JWT token");
await client.close();
For Humans
Stop grepping through thousands of Markdown files. Ask GNO questions in plain English and get cited answers from your own notes, documentation, and code.
The Web UI provides a visual dashboard for search, browsing, editing, and AI-powered answers. Filter by tags extracted from your frontmatter for instant precision.
Knowledge Graph
See how your ideas connect. The interactive knowledge graph visualizes wiki links, markdown links, and semantic similarity as a navigable constellation. Click any node to jump to that document.
