Knowledge
A search index of your project, so agents find the right files first.
Knowledge is a search index of your project. It lets Kongo and other agents find the right files before reading them, instead of searching file by file. It covers project files, Work Graph records and Patch Log records.
Turn it on
Knowledge is off for each project until you turn it on. Click Scan now on the card when a project first opens, or go to Knowledge in the project's settings, tick Enable Knowledge for this project, then click Start initial scan.
The scan runs in batches and can be stopped and resumed safely. After that, Knowledge keeps itself current in the background as you work.
The Knowledge model
| Option | What happens |
|---|---|
| Qwen3, built in (recommended) | A small model that ships with Tortilloid and runs on your Mac. The default. |
| OpenAI, with your API key | Text chunks are sent to OpenAI to be indexed. |
Private by default. If the built-in model is ever unavailable, Knowledge falls back to basic word matching on your Mac. Text only goes to OpenAI when you choose the OpenAI option yourself.
Changing the model rebuilds the index on the next scan, and your current index keeps working until then.
How agents search
Each answer comes with a confidence level. High means an agent can act on the files, medium means it should check them first, and low means they are only leads.
Super Search
Super Search lets you search the whole project yourself, in plain language. Press Shift+Cmd+F on any screen, or choose Super Search… from the Edit menu. Press the shortcut again to close it.
Type a question, like "where do we retry failed payments?". Results are ranked across three kinds of record, with a confidence level at the top.
| Result | Opens |
|---|---|
| Code | The file, with the matching line highlighted. |
| Thread | Work Space, showing that thread's details. |
| Patch | Global History, with that change selected. |
Click a result, or use the arrow keys and Enter. Send to Kongo, or Cmd+Enter, opens a new Kongo chat with your search attached, ready for your question. Nothing is sent until you send it.
With Knowledge off for a project, Super Search still finds threads and patches, but doesn't search code.
Keep noise out
Vendored libraries, build output and generated files make search slower and worse. Agents can add folders like these to the project's ignore list.