Common Ink
All docs

Search

Every folder's list, All notes among them, and the Todos page share one search bar and one query language. This page shows how a query is read, how to build one with Advanced, and every filter there is.

A search bar heads every folder's list and shows the folder it searches. With nothing typed, the list is the folder's notes. Type a query and the list becomes the notes in that folder that match, each card with the lines that matched.

All notes, the first row of the folder tree, is the same list over every note you can see, and Go to Search in the command palette opens it with the keyboard in its search bar. What you type goes into the page's address, so you can link to a search, reload it, or come back to it. The Todos page has the same bar for todos, and the Uploads page has it for files. Your agents and the ink CLI read the same language.

As you type a filter's name or value, the bar offers completions. Tab takes the first, the arrow keys move, and Enter takes the one you moved to. Folders, tags, and people are offered from what you can already see.

How a query is read

  • A word matches a note that has that word, or a word that starts with it, ignoring case and accents.
  • "second quarter" matches the words together, in that order.
  • A space between terms means AND. OR means either. AND, OR, and NOT are operators only in capitals, so or is a word.
  • - before a word, a phrase, a filter, or a group excludes it. NOT does the same.
  • Parentheses group terms, up to 8 deep. NOT binds first, then AND, then OR.
  • key:value is a filter. Put a value with a space in quotes, as in folder:"Common Ink".
  • Dates and numbers compare with >, >=, <, <=, and ranges with a..b. * leaves one side of a range open.
  • A day is YYYY-MM-DD, or a day counted from today, such as today, yesterday, tomorrow, 7d for seven days ago, and +7d for seven days ahead.
  • #money is short for tag:money, and no:tag is short for -has:tag.

A query has at most 40 terms and 200 characters.

A search covers live notes. Archived notes are included only when the query says is:archived, and Trash only when it says is:trashed. So is:archived alone lists archived notes, and budget (is:open OR is:archived) searches both.

Notes whose title matches come first, then the most recently changed. A sort: filter changes the order, and in:title looks for the words in titles only.

If the bar can't read a query, it says why under the field and marks the part that is wrong. A misspelt filter is an error, not a search. For foldr:Projects, the bar asks whether you meant folder:. A word is still read as words when a digit or a symbol comes before its colon, or when nothing or a / follows it, as in 10:30, re:, and https://example.com.

Build a query with Advanced

Press Advanced beside the bar to open the builder. Each condition is a row with a field, is or is not, a comparison where the field has one, and a value. Add a condition adds a row. Match all or Match any joins the rows. Words in and Sort set where words are looked for and the order.

Each change is written into the bar, and what you type in the bar is read back into the rows. A query the rows can't show, such as one with a group inside it, stays as you typed it.

Press ? in the builder to open the query syntax help. Every example in it is a button that runs the query.

List a search in a note

Write /search( and a query ) in a note, or pick Search results from the / menu, and the note lists the notes the query finds. The list keeps itself up to date: a note that starts to match joins it a moment later, with no reload.

/search(created:today)
/search(tag:work updated:>=7d limit=5)
  • The words between the parentheses are the query, exactly as a search bar takes it. limit=5 after the query sets how many notes are listed, from 1 to 50. Without it the list shows 10, and a line under it links to the rest.
  • Each row shows a note's title, its folder, and when it was edited. Click a row to open the note. The query in the list's head opens All notes searched for it.
  • The list is searched as whoever is reading the note. Each reader sees only the notes they can see, and today or 7d counts from their own day. A date written out, such as created:2026-11-10, stays that day.
  • The note the list is in is left out of it. Search doesn't find a note by a list's query either: a note with /search(zebra) in it isn't found by searching for zebra.
  • A tag in the query, #work or tag:work, narrows the list and doesn't tag the note the list is in.
  • The settings button in the list's head has the query and the limit. The query is set with the same search bar a folder's page has: it offers filters and their values as you type, Advanced builds a query from conditions, and the list follows what you type. A query the bar can't read is left out of the note until it can.

On a page opened from a share link the list shows no notes, because nobody there is a member.

A new daily note starts with one of these: /search(created:2026-11-10), with the note's own date, lists the notes made that day.

Examples

To find Type
Notes you changed this week that still have an open todo editor:@me updated:>=7d has:open-todo
A phrase in one folder and the folders inside it folder:Projects "launch plan"
Notes tagged money but not taxes #money -#taxes
Notes with either word in the title (budget OR forecast) in:title
Archived notes about the budget budget is:archived
Notes made in October that have no tags created:2026-10-01..2026-10-31 no:tag
Notes that mention a person mentions:"Grace Hopper"
Notes that show a file, oldest change first has:attachment sort:updated-asc
Todos assigned to you and overdue, on the Todos page assignee:@me due:<today
Large files no note uses, on the Uploads page used:no size:>10mb

@me stands for you in editor:, author:, mentions:, assignee:, and uploader:.

folder:, editor:, author:, and uploader: must name something you can see. A name that matches nothing is refused with a message, so a typo doesn't look like an empty result.

Every filter

Notes

Write It finds Example
word Has the word, or one that starts with it, ignoring case and accents budget
"a phrase" Has the words together, in that order "second quarter"
a b Both: a space is AND, which can also be written budget plan
a OR b Either. OR, AND and NOT are operators only in capitals budget OR plan
-a, NOT a Not: before a word, a phrase, a filter or a group budget -plan
( ) Groups, up to 8 deep. NOT binds first, then AND, then OR (budget OR plan) -draft
key:>DAY, >=, <, <= After, on or after, before, on or before a day or a number updated:>2026-10-01
key:A..B From A to B, both included. * leaves one side open created:2026-10-01..*
today, yesterday, tomorrow, 7d, +7d A day counted from today: 7d is seven days ago, +7d seven days ahead updated:>=7d
#NAME Short for tag:NAME #money
key:"a value" A value with a space in it is written in quotes folder:"Common Ink"
folder:NAME In a folder, named or by its id, or in a folder inside it folder:Unsorted
tag:NAME Tagged with it or a tag inside it, as #NAME/sub. #NAME is short for it. A note has every tag written in it. A todo has the ones on its line, a heading's over it, a line of tags' above it in its section, and a list item's it is nested in tag:money
updated:DAY The day the note was last changed updated:>=2026-10-01
created:DAY The day the note was made created:2026-10-01..2026-10-14
editor:NAME, edited-by:NAME Changed by a member or an agent, by name. @me is you editor:@me
author:NAME First written by a member or an agent, by name. @me is you author:@me
mentions:NAME, mention:NAME Mentions a person, by name or id. @me is you mentions:"Grace Hopper"
mentions-agent:NAME Mentions an agent or any subagent under it, by name or id mentions-agent:"Grok Bot"
is:open Not archived and not in Trash is:open
is:archived Archived. A query that doesn't say so leaves archived notes out is:archived
is:trashed In Trash. A query that doesn't say so leaves Trash out is:trashed
is:private In your own Private: only you, and whoever you let in, see it is:private
is:shared In a shared folder you are in: one for everyone, or one that names you is:shared
is:everyone In a shared folder for everyone in the workspace is:everyone
is:named In a shared folder that names the people in it is:named
is:withme Shared with you: someone let you in to it, or to a folder it is in, from where you see nothing else is:withme
is:granted Shared by itself with a person or by a link, where you may see how it is shared is:granted
has:todo Has a todo, in any state has:todo
has:open-todo Has an open todo has:open-todo
has:link Links to another note has:link
has:backlink Linked to from a note you can see has:backlink
has:tag Has any tag has:tag
has:attachment Shows an upload: a picture, a video, sound or a file has:attachment
no:WORD Lacks it: the same as -has:WORD no:todo
in:title Every word of the query is looked for in the note's title budget in:title
in:body Every word is looked for in the note's text, or for a todo in its line budget in:body
sort:updated-desc Latest changed first sort:updated-desc
sort:updated-asc Longest unchanged first sort:updated-asc
sort:created-desc Newest first sort:created-desc
sort:created-asc Oldest first sort:created-asc
sort:title-asc By the note's title, A to Z sort:title-asc
sort:title-desc By the note's title, Z to A sort:title-desc

Todos

Write It finds Example
word Has the word, or one that starts with it, ignoring case and accents budget
"a phrase" Has the words together, in that order "second quarter"
a b Both: a space is AND, which can also be written budget plan
a OR b Either. OR, AND and NOT are operators only in capitals budget OR plan
-a, NOT a Not: before a word, a phrase, a filter or a group budget -plan
( ) Groups, up to 8 deep. NOT binds first, then AND, then OR (budget OR plan) -draft
key:>DAY, >=, <, <= After, on or after, before, on or before a day or a number updated:>2026-10-01
key:A..B From A to B, both included. * leaves one side open created:2026-10-01..*
today, yesterday, tomorrow, 7d, +7d A day counted from today: 7d is seven days ago, +7d seven days ahead updated:>=7d
#NAME Short for tag:NAME #money
key:"a value" A value with a space in it is written in quotes folder:"Common Ink"
folder:NAME In a folder, named or by its id, or in a folder inside it folder:Unsorted
tag:NAME Tagged with it or a tag inside it, as #NAME/sub. #NAME is short for it. A note has every tag written in it. A todo has the ones on its line, a heading's over it, a line of tags' above it in its section, and a list item's it is nested in tag:money
updated:DAY The day the note was last changed updated:>=2026-10-01
created:DAY The day the note was made created:2026-10-01..2026-10-14
editor:NAME, edited-by:NAME Changed by a member or an agent, by name. @me is you editor:@me
author:NAME First written by a member or an agent, by name. @me is you author:@me
assignee:NAME, assigned:NAME Assigned to a person: mentioned on the todo's line, by name or id. @me is you assignee:@me
assignee-agent:NAME Assigned to an agent or any subagent under it, by name or id assignee-agent:"Grok Bot"
is:open A box written [ ]: open. A query that names no state lists only open todos is:open
is:done A box written [x]: done. With is:open OR is:done, both is:done
is:abandoned A box written [-]: abandoned, which won't be done is:abandoned
is:backlog A box written [>]: in the backlog, put off for some day is:backlog
is:archived In an archived note. A query that says neither this nor -is:archived follows the Todos in archived notes setting is:archived
is:trashed In Trash. A query that doesn't say so leaves Trash out is:trashed
is:private In your own Private: only you, and whoever you let in, see it is:private
is:shared In a shared folder you are in: one for everyone, or one that names you is:shared
is:everyone In a shared folder for everyone in the workspace is:everyone
is:named In a shared folder that names the people in it is:named
is:withme Shared with you: someone let you in to it, or to a folder it is in, from where you see nothing else is:withme
is:granted Shared by itself with a person or by a link, where you may see how it is shared is:granted
has:link Links to another note has:link
has:backlink Linked to from a note you can see has:backlink
has:tag Has any tag has:tag
has:due Has a due date has:due
has:repeat Repeats has:repeat
no:WORD Lacks it: the same as -has:WORD no:link
due:DAY The day a todo is due. Overdue is due:<today due:<today
priority:LEVEL, importance:LEVEL A todo's priority: high, medium, low or none, written !!!, !!, ! or nothing. 3 to 0 read the same priority:>=medium
in:title Every word of the query is looked for in the note's title budget in:title
in:body Every word is looked for in the note's text, or for a todo in its line budget in:body
sort:updated-desc Latest changed first sort:updated-desc
sort:updated-asc Longest unchanged first sort:updated-asc
sort:created-desc Newest first sort:created-desc
sort:created-asc Oldest first sort:created-asc
sort:title-asc By the note's title, A to Z sort:title-asc
sort:title-desc By the note's title, Z to A sort:title-desc
sort:due-asc Soonest due first, and those with no due date last sort:due-asc
sort:due-desc Latest due first, and those with no due date last sort:due-desc
sort:priority-desc Highest priority first sort:priority-desc
sort:text-asc By the todo's words, A to Z sort:text-asc

Uploads

Write It finds Example
word Its name has the word in it, ignoring case report
"a phrase" Its name has the words in that order "q2 report"
a b Both: a space is AND, which can also be written report type:pdf
a OR b Either. OR, AND and NOT are operators only in capitals type:image OR type:video
-a, NOT a Not: before a word, a phrase, a filter or a group -type:image
( ) Groups, up to 8 deep. NOT binds first, then AND, then OR (type:pdf OR type:text) used:no
key:>VALUE, >=, <, <= After, on or after, before, on or before a day; larger, at least, smaller, at most a size size:>=500kb
key:A..B From A to B, both included. * leaves one side open size:1mb..5mb
today, yesterday, tomorrow, 7d, +7d A day counted from today: 7d is seven days ago, +7d seven days ahead uploaded:>=7d
key:"a value" A value with a space in it is written in quotes name:"Q2 report"
name:TEXT The name has this in it, ignoring case name:report
type:image A picture type:image
type:video A video type:video
type:audio Sound type:audio
type:pdf A PDF type:pdf
type:text Text to read, by its name's ending: txt, md, markdown, csv, tsv, json, log, yaml, yml, toml, xml, html, css, js, ts, py, sh, sql type:text
type:other Any other file type:other
uploader:NAME, uploaded-by:NAME Uploaded by a member or an agent, by name. @me is you uploader:@me
used:yes A note you can see shows it used:yes
used:no No note you can see shows it used:no
size:SIZE How big the file is: bytes, or kb, mb or gb size:>1mb
uploaded:DAY The day the file was uploaded uploaded:>=2026-10-01
is:open Not archived and not in Trash is:open
is:archived Archived. A query that doesn't say so leaves archived uploads out is:archived
is:trashed In Trash. A query that doesn't say so leaves Trash out is:trashed
is:private You uploaded it, and no note shows it but in your own Private is:private
is:shared A note in a shared folder you are in shows it: one for everyone, or one that names you is:shared
is:everyone A note in a shared folder for everyone in the workspace shows it is:everyone
is:named A note in a shared folder that names the people in it shows it is:named
is:withme Shared with you: you didn't upload it, and see it by no note in a shared folder of yours or your Private is:withme
is:granted Shared by itself with a person or by a link, where you may see how it is shared is:granted
sort:uploaded-desc Latest uploaded first sort:uploaded-desc
sort:uploaded-asc Earliest uploaded first sort:uploaded-asc
sort:name-asc By the file's name, A to Z sort:name-asc
sort:size-desc Largest first sort:size-desc