skills/gno/SKILL.md
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.
npx skillsauth add gmickel/gno gnoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Fast local semantic search. Index once, search instantly. No cloud, no API keys.
gno 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
| Category | Commands | Description |
| ------------ | ---------------------------------------------------------------- | --------------------------------------------------------- |
| Search | search, vsearch, query, ask | Find documents by keywords, meaning, or get AI answers |
| Links | links, backlinks, similar, graph | Navigate document relationships and visualize connections |
| Retrieve | get, multi-get, ls | Fetch document content by URI or ID |
| Index | init, collection add/list/remove, index, update, embed | Set up and maintain document index |
| Tags | tags, tags add, tags rm | Organize and filter documents |
| Context | context add/list/rm/check | Add hints to improve search relevance |
| Models | models list/use/pull/clear/path | Manage local AI models |
| Serve | serve | Web UI for browsing and searching |
| Publish | publish export | Export gno.sh publish artifacts |
| MCP | mcp, mcp install/uninstall/status | AI assistant integration |
| Skill | skill install/uninstall/show/paths | Install skill for AI agents |
| Admin | status, doctor, cleanup, reset, vec, completion | Maintenance and diagnostics |
| Command | Speed | Best For |
| ---------------------- | ------- | ---------------------------------- |
| gno search | instant | Exact keyword matching |
| gno vsearch | ~0.5s | Finding similar concepts |
| gno query --fast | ~0.7s | Quick lookups |
| gno query | ~2-3s | Balanced (default) |
| gno query --thorough | ~5-8s | Best recall, complex queries |
| gno ask --answer | ~3-5s | AI-generated answer with citations |
Retry strategy: Use default first. If no results: rephrase query, then try --thorough.
-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
--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
Non-default index search results may include ?index=<name> on gno:// URIs.
Keep that query string when passing the URI to gno get.
If you edit/create files that should be searchable via vector search:
gno 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.
| Topic | File | | ----------------------------------------------------- | ------------------------------------ | | Complete CLI reference (all commands, options, flags) | cli-reference.md | | MCP server setup and tools | mcp-reference.md | | Usage examples and patterns | examples.md |
development
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.
development
Maintainer-only workflow for handling GitHub Secret Scanning alerts on OpenClaw. Use when Codex needs to triage, redact, clean up, and resolve secret leakage found in issue comments, issue bodies, PR comments, or other GitHub content.
development
Maintainer workflow for OpenClaw releases, prereleases, changelog release notes, and publish validation. Use when Codex needs to prepare or verify stable or beta release steps, align version naming, assemble release notes, check release auth requirements, or validate publish-time commands and artifacts.
development
Run, watch, debug, and extend OpenClaw QA testing with qa-lab and qa-channel. Use when Codex needs to execute the repo-backed QA suite, inspect live QA artifacts, debug failing scenarios, add new QA scenarios, or explain the OpenClaw QA workflow. Prefer the live OpenAI lane with regular openai/gpt-5.4 in fast mode; do not use gpt-5.4-pro or gpt-5.4-mini unless the user explicitly overrides that policy.