Search the list and the archive
findSearch open and archived tasks and documents by keywords, dates, tags, lists, sources, or agent status to locate past decisions; search inside one document for matching lines with context.
Instructions
Search the tasks — open and archived alike — and the documents: by words with query, by what a task is with the sifting fields (alone or narrowing a query), or by source alone to see whether something was filed from it already. A task found by what its page, description, steps or notes say comes with in and the line that says it, so a past decision often reads without read. With doc it searches inside that one document instead and hands back the matching lines with their numbers and the section each sits in.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Its date or deadline on this day or before | |
| doc | No | Look inside this one document rather than across the tasks. Hands back the lines where every word of the query turns up, accents or not, with their numbers, the lines around them unless every one of those is blank, and the section each sits in. A line in `around` is cut at 200 characters; `read_doc` with `from` and `to` brings it whole | |
| tag | No | Carrying this tag, with or without the #. Any sifting field leaves the documents out of the answer | |
| from | No | Its date or deadline on this day or after (2026-08-31) | |
| list | No | In this list, named as `lists` names it | |
| after | No | Skip this many tasks, to page on while `total` is higher than what came back. Documents are not paged: `docsTotal` says how many match, and a higher `limit` brings more | |
| limit | No | At most 100, 20 by default | |
| query | No | Words to look for, not a phrase: each word has to turn up in the same task or document (on the same line, with `doc`), in any order, accents or not; put a phrase in quotes when the order is the point. Not needed when sifting by the fields below | |
| scope | No | Defaults to either: the open tasks and the archive together, which is where how something was solved before is found | |
| around | No | With `doc`: how many lines to bring on each side of a hit, 1 by default, 0 for none, at most 10 | |
| folder | No | Only the documents in this folder and the folders below it, by its name, its whole path or its id. Documents whose title says the words come first either way, before those that only mention them | |
| source | No | Ask whether this exact source was proposed already | |
| part_of | No | Only the parts of this task, by its id | |
| by_agent | No | True for what an agent filed, false for what the person wrote | |
| said_done | No | True for what an agent spoke for — said done, or said should not be done — and the person has not decided yet; false for what nobody spoke for | |
| from_source | No | Only tasks whose `source` starts with this, however it is written: «sereno», «sereno#» and «sereno: » all bring everything read out of that one place | |
| open_to_agents | No | True for the person's own tasks they opened to agents — yours to fill in and to say done — false for what they kept to themselves |