Skip to main content
Search in a workspace understands meaning as well as words: you ask a question in your own terms and get the passages that answer it.
  • You do not need the exact words. A question about “auth failures” finds a passage titled “retry strategy for expired credentials”.
  • Your agent reads the answer, not every file. Each result comes with its best passages.
  • Exact terms still work. A document that uses your words and means what you asked ranks highest.
Example. A SaaS support lead asks, “how do we handle refunds after 30 days?” The policy document never uses the word “refund” in its heading. Search returns the passage under “Late cancellations”, and the agent answers from it.

Ask a workspace a question

In a workspace, a search ranks documents by their words and by their meaning together. Each result carries up to three of the document’s best passages, best first, each with the heading it sits under. Text documents in a workspace are indexed by themselves when they are saved: documents, web pages, code and plain text. There is nothing to switch on.
Example. A consulting firm’s agent is asked what the client said about budget. It searches the client workspace and gets three passages from two sets of meeting notes, without opening the other forty files.

Ask one document a question

A search can be pointed at a single document. The answer is that document’s most relevant passages.
Example. A finance team’s agent is asked about the termination clause in a 60-page supplier contract. It searches that one contract and reads the five passages that matter.

Find an exact term and nothing else

Search by meaning always returns the closest documents, even when none contains your words. Each result says whether it was found by its words or by meaning alone. When you want an exact identifier, such as a ticket number or a product code, ask for an exact-word search. Only documents that contain the words come back, and none when none does.
Example. A dev team’s agent looks for ticket “PAY-482”. An exact-word search returns the two documents that mention it, and nothing that is merely about payments.

What you see

  • Search in the web app (⌘K, or Ctrl K). In a workspace it finds files by name and passages inside them.
  • Before you type, it shows the workspace’s pinned files, recently changed files and places.

Ask your agent

  • “Search the client workspace for what we agreed about pricing.”
  • “What does the supplier contract say about ending early?”
  • “Find every document that mentions PAY-482, exact matches only.”
  • “Which of our notes talk about onboarding problems?”

Good to know

  • Search by meaning works inside a workspace. Files outside any workspace are found by their words only.
  • A document saved a moment ago is found by its words at once, and by meaning usually within seconds.
  • If search by meaning is unavailable for a moment, the search still answers, by words.
  • Everyone in a workspace searches all of its documents. Nobody outside it gets results from them.
  • Nothing in the trash appears in search.

For agents and developers

Search rules

What is indexed, ranking, passages and pending content

CLI: search

The search command

API: search

The route, inputs and response