Reference

CLI commands

Reference for every gno command — search, query, ask, index, collection, and more.

The CLI is a first-class surface in GNO. Every command that the Web UI exposes is available from the shell, with structured output modes for scripting.

Search commands

gno search "exact terms" # BM25 keyword, ~5–20ms
gno vsearch "concept" # Vector similarity, ~0.5s
gno query "topic" # Hybrid with reranking, default ~2s
gno query "topic" --thorough # Highest quality mode
gno ask "question" --answer # Cited answer via local LLM

Common flags

• --collection <name> / -c — scope to one collection
• --tags-any tag1,tag2 — OR filter by tags
• --tags-all tag1,tag2 — AND filter
• --since "last week" — temporal filter with natural language
• --exclude doc.md — exclude specific docs
• --limit 20 — cap result count
• --explain — show the retrieval pipeline trace

Output formats

• --json — JSON for piping to jq
• --csv — CSV rows
• --md — Markdown table
• --files — URIs only, one per line
• --xml — XML output for structured tooling

Index management

gno init <path> # Initialize a new collection
gno index # Ingest + embed all collections
gno update # Re-scan for changes
gno embed <collection> # Re-embed one collection
gno ls # List indexed documents
gno doctor # Diagnose config and models

Collection management

gno collection add <path> --name <name>
gno collection list
gno collection remove <name>
gno collection clear-embeddings <name>

Links and graph

gno links doc.md
gno backlinks doc.md
gno similar doc.md
gno graph --collection notes

Model management

gno models use balanced
gno models pull
gno models list
gno models current

Integrations

gno mcp install --target cursor
gno skill install --scope user
gno publish export atlas --out ~/Downloads/atlas.json
gno serve
gno daemon

To hand off a note or collection to gno.sh, export a compiled artifact locally with gno publish export, then upload that JSON file at /studio.