gno

A local search system for files, documents, notes, and code. It can index folders and find information by matching words or meaning, with answers that cite the source material.

In plain words
What is it for?
Indexing folders; searching PDFs, Markdown, Word documents, and code; answering questions from local files; browsing document relationships; and preparing evidence for agent tasks.
Why use it?
It avoids manually opening many files or building a separate online knowledge base to find relevant information.

Skill for Claude CodeCodex

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/gmickel/gno/skill
Any agent
npx skills add gmickel/gno --skill skill
Clone the repo
git clone --depth 1 https://github.com/gmickel/gno

Made for: Claude Code, Codex.

Per session 86 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 7,561 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 97% copy Near-identical to another mod 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.

ModelPer sessionOnce invoked
Fable 5 $0.00086 $0.07561
Opus 5 $0.00043 $0.03780
Sonnet 5 $0.00017 $0.01512
Haiku 4.5 $0.00009 $0.00756

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

Security

Grade A, and why

gno scanned grade A with 0 findings 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 3d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

97% identical to gno — 29 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

assets/skill/SKILL.md · 618 lines

How it starts

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

GNO - Local Knowledge Engine

Fast local semantic search. Index once, search instantly. Local inference needs no API key; configured HTTP backends and explicit gno.sh publishing are separate network boundaries.

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 wants a deterministic, budgeted evidence bundle for an agent task
  • 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
  • User wants to export a note or collection for gno.sh publishing

Quick Start

gno setup ~/docs --name docs          # Index + prove exact BM25; semantic continues
gno search "your query"               # BM25 keyword search

gno setup is the default activation path. It is idempotent, returns only after exact lexical proof, and runs directly without resident/Web/MCP attachment. Use --no-semantic to start no worker and record skipped state. Inside a repository with .gno/index.yml, setup inspects the optional profile before mutation. Run gno profile diff, then gno setup . --apply-profile to apply its portable collection/context/content rules before setup proves retrieval. Missing/invalid profiles keep ordinary setup usable; no profile is applied implicitly. Use repeatable --connector with claude-code-skill, claude-desktop-mcp, cursor-mcp, codex-skill, opencode-skill, openclaw-skill, or hermes-skill. Connector skips/failures can return completed_with_actions without invalidating lexical success. Skill targets are installed but report target_runtime_unverifiable.

Read the full file on GitHub · 618 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.

  1. 3d ago First seen · 618 lines · 86 tokens per session scan A 69fc20500723

Subscribe to this mod's changes

gno is a skill published in the GitHub repository gmickel/gno (109 stars, last pushed 3d ago), licensed MIT. It adds 86 tokens to every session and 7,561 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. It is 97% identical to gno, differing in 29 lines, and is treated as a copy.