Search⌘K

How do I search the knowledge base?

How to use the knowledge base search, including the streaming AI answer card.

Every page has search built in. Type a few words and you get matching docs — runbooks, APIs, guides, FAQs — grouped by type, plus an AI-written answer that cites its sources. You only ever see docs you're allowed to open.

  • The search pill in the top bar (magnifier + "Search" + ⌘K) — on every page except the home page and the search results page.
  • The big search box on the home page — type a query and press Enter.

Both routes go to the /search page.

Typing your query

Just start typing — results update as you type. Search tries the server first: signed-in users get full body-text matching across all their permitted docs. If the server can't be reached, it falls back to a public, browser-side index. Both do fuzzy and prefix matching, so near-misses and partial words still return sensible hits.

The AI answer

Once your query is at least two characters, an AI Answer card appears above the results. It reads the most relevant docs and streams back a written answer with numbered citations that link to the source docs. The answer covers only docs you're allowed to see; if nothing matches, the card says so rather than guessing.

The AI answer is a summary, not the source of truth. Follow a citation to the actual doc before acting on anything.

Results are grouped by type

GroupWhat it finds
RunbooksStep-by-step operational procedures
APIsAPI reference docs
GuidesGuides, FAQs, and training material
DiagramsDiagrams, architecture, database, and portal docs

Each result shows its title, a highlighted snippet, and the doc's last-updated date.

Narrowing with scope chips

Below the search box, scope chips — Everything, Runbooks, APIs, Guides, Diagrams — each show a live match count. Click one to filter; click Everything to go back. No special syntax to learn.

Why you might not see something

  1. Signed-out visitors see public docs only. Sign in to reach all docs your account holds.
  2. Your spaces. Each doc is tagged with spaces; a doc outside yours won't appear. A Code Nexas platform admin can grant you the space you need — sign out and back in afterwards.

A doc appearing in search doesn't grant extra access — opening it uses the same permissions you already have.

Where to learn more