---

name: gno description: Search local documents, files, notes, and knowledge bases. Index directories, search with BM25/vector/hybrid, get AI answers with citations. Use when user wants to search files, find documents, query notes, look up information in local folders, index a directory, set up document search, build a knowledge base, needs RAG/semantic search, or wants to start a local web UI for their docs. allowed-tools: Bash(gno:*) Read

GNO - Local Knowledge Engine

Fast local semantic search. Index once, search instantly. No cloud, no API keys.

When to Use This Skill

• User asks to search files, documents, or notes
• User wants to find information in local folders
• User needs to index a directory for searching
• User mentions PDFs, markdown, Word docs, code to search
• User asks about knowledge base or RAG setup
• User wants semantic/vector search over their files
• User needs to set up MCP for document access
• User wants a web UI to browse/search documents
• User asks to get AI answers from their documents
• User wants to tag, categorize, or filter documents
• User asks about backlinks, wiki links, or related notes
• User wants to visualize document connections or see a knowledge graph

Quick Start

Copygno init                              # Initialize in current directory
gno collection add ~/docs --name docs # Add folder to index
gno index                             # Build index (ingest + embed)
gno search "your query"               # BM25 keyword search

Command Overview

Search Modes

Retry strategy: Use default first. If no results: rephrase query, then try --thorough.

Common Flags

Copy-n <num>              Max results (default: 5)
-c, --collection      Filter to collection
--tags-any <t1,t2>    Has ANY of these tags
--tags-all <t1,t2>    Has ALL of these tags
--json                JSON output
--files               URI list output
--line-numbers        Include line numbers

Global Flags

Copy--index <name>    Alternate index (default: "default")
--config <path>   Override config file
--verbose         Verbose logging
--json            JSON output
--yes             Non-interactive mode
--offline         Use cached models only
--no-color        Disable colors
--no-pager        Disable paging

Important: Embedding After Changes

If you edit/create files that should be searchable via vector search:

Copygno index              # Full re-index (sync + embed)
# or
gno embed              # Embed only (if already synced)

MCP gno.sync and gno.capture do NOT auto-embed. Use CLI for embedding.

Reference Documentation