Tortilloid
How it works / Knowledge

Docs / How it works / Knowledge

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

OptionWhat happens
Qwen3, built in (recommended)A small model that ships with Tortilloid and runs on your Mac. The default.
OpenAI, with your API keyText 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.

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 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.

ResultOpens
CodeThe file, with the matching line highlighted.
ThreadWork Space, showing that thread's details.
PatchGlobal 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.