Search & the command palette

A fast local index covers your desktop, portal folders, and any extra roots you add — filenames, file contents, even text inside screenshots. Nothing ever leaves your machine.

In-picket search

Plain filename searches respond after a shorter typing pause than flagged queries. Content, recursive and other flagged searches keep their existing pause to avoid starting expensive work on every keystroke.

Click the magnifier in a picket's title bar (or the picket menu → Search this picket). Plain terms match the picket's items — AND-combined, case-insensitive. Quote "literal terms" to match exactly. In a portal, search covers the folder currently open in its breadcrumbs; -r includes its subfolders. A smart picket searches its current matching items. A regular collection searches its references, including folders outside the Desktop; -r searches inside them.

An empty search box leaves the grid its keys: until you type, the grid is still on screen, and once a tile has focus Enter, Delete, F2, the arrows and type-ahead work as usual; Esc from the grid closes the empty box. As soon as you type, the results replace the grid and the keys belong to the search box.

Result limits and order

Picket search and the global overlay show at most 200 filename results. A notice appears if another match was found beyond those 200; exactly 200 matches does not trigger it. Content search stops at 200 matching files and reports that the limit was reached; there may be more. Narrow your terms, use -t, or search a smaller folder to check other matches. These limits are separate from the grid's 1,000-item More/Back pages.

Ordinary content snippets show up to three matching lines per file, with each line limited to 240 characters. Image OCR uses a shorter excerpt of up to 120 characters.

Plain filename searches prefer exact names, then prefixes, word-start matches and matches inside a name. Among equally good matches, Picket's recorded open frequency and recency help break ties, followed by name length and name. This history records opens through Picket and is stored in the workspace. Results need not be alphabetical or follow the picket's grid sort. This relevance ordering does not describe content or regex results.

PDF/Office text and image OCR caches use file size and the full modification timestamp, so quick same-size edits invalidate old text. A file changed during extraction is skipped until the next search. Precision depends on the filesystem; older OCR cache entries are rebuilt when needed. A document whose text cannot be read (damaged, password-protected, a PDF the reader cannot parse, or an Office file whose zip container is not the plain kind Office writes: ZIP64 end records, a part listed twice, data before the archive, or a directory entry whose extra field is malformed, holds more than 16 sub-fields or 1 KiB, or repeats the ZIP64 field) is tried once per version: it matches nothing until the file changes, and picket.log names it once.

PDFs are read by a second, short-lived picket-app.exe that exits as soon as it has answered and is stopped after 30 s. Picketdesk also requests a 1 GB memory limit through a Windows job object: with it in place, a PDF that unpacks past 1 GB ends the helper and costs only that file's text. If Windows refuses that limit, the helper still reads PDFs without a memory cap, and picket.log warns once per session if the helper returns before the timeout. The timeout still applies, but a crafted PDF may consume substantial memory before it expires. Running the reader separately protects Picketdesk from a crash in the PDF reader. You may see it in Task Manager during a content search; ending it is harmless.

Search flags

Flags combine anywhere in the query, and can be bundled (-rc = recurse + content):

FlagMeaning
-rRecurse into the picket's folders, including a full picket of 1,000 folder items.
-gGlobal — search everything indexed, not just this picket.
-cContent search inside files — streams results live; includes PDF, Word, Excel and PowerPoint text, and OCR of png/jpg/jpeg/bmp images; skips binaries, files over 4 MB, and cloud placeholders. A document's text is searched up to its first 8 MB. It searches contents only, never names, and several words are one phrase: q3 report -c finds “q3 report” in that order.
-eTreat the terms as a regular expression.
-t pdf,txtRestrict to extensions.
-d 30Created or modified within the last N days — a file copied onto the desktop today counts, even though Windows kept the original’s write time.

Those are the whole set — anything else after a - is reported as an unknown flag rather than silently ignored. -t and -d take a value, so they must come last in a bundle (-rt pdf works, -tr pdf does not).

Examples:

QueryFinds
invoice -c -t pdfPDFs containing the word “invoice”.
-g -t png -d 7Every PNG modified this week, anywhere indexed.
report -rc“report” inside files (contents only — a -c search never matches names), recursing into folders.
-e ^IMG_\d+Names matching a regular expression.

Results show icon, name, path, size, and date; content hits show the matched lines with line numbers and highlights — screenshot text matches show a 🖼 snippet. Right-click any result for the full item menu. ↓ from the search box walks the results and Enter opens the lit one — the keyboard route to a -g/-r hit the grid does not draw. Nothing is lit until you press ↓, so an Enter while you type still opens nothing; ↑ from the first result goes back to typing. The keys only walk results that are on screen: on a rolled-up picket ↓, Enter and Ctrl+Enter do nothing until you expand it — or while a hover on its bar has it unrolled, when its results show and the keys work — and a locked private picket cannot be searched at all. Screen readers hear the lit row as ↓ moves. Ctrl+Enter turns the results into a real selection: the matching items in this picket become the grid selection and the search closes, so a query like -t zip -d 365 flows straight into the bulk actions (move, tag, Delete, drag). Only items the grid actually draws are selected. Click ★ to save the query as a smart picket. Note that a smart picket always views your desktop and never reads inside files: -g, -r and -c are stripped when the query is saved and ignored if present, while terms, -t, -d and -e carry over (-d still means created or modified). The picket is named after the query's terms, not its syntax. See why. A query with nothing left to filter by once those are stripped (-g alone, or a bare -e) is not saved: it would list, and hide, your whole desktop, so a toast asks for words, -t or -d instead.

The global overlay — Ctrl+Shift+F

Search everything from anywhere: ↑↓ select, Enter opens, Esc closes, right-click menus and all flags work. An empty query shows your 15 most recently modified files (a private picket's files are left out, and the next newest take their places) — often all you need, and the arrow keys walk them too: Ctrl+Shift+F, Enter reopens the file you changed last. The overlay dismisses on focus loss, but not for its own menus: right-click a result and choose Explorer menu… and the overlay waits behind it, taking focus back if you dismiss that menu without picking anything.

An Apps row above the results launches Start Menu programs by name — type code → Visual Studio Code. It shows up to four, from the Start Menu as Picketdesk found it at launch (a program installed since appears after the next start), and never an uninstaller's shortcut. Click an app, or press ↑ from the first result to reach the row (↑ again for the next app) and Enter to launch it. Enter on its own still opens the first file; when no file matches at all, it launches the top app. Changing the query removes the previous query's apps from the row and keyboard selection while new results load. Screen readers hear the lit row — a recent file, a result or an app — as ↑↓ move.

On more than one screen, the overlay opens centred on the monitor your cursor is on, inside that screen's work area and sized for its DPI — press the chord while working on the second monitor and the launcher is there, not on the primary one. The page-switch strip follows the same rule.

The command palette

Type a command into the overlay instead of a search — Enter runs it; anything unrecognized stays a search. Repeated Enter presses while a command is running do not submit it again, and its reply keeps any text you typed afterwards:

CommandDoes
move report.pdf to WorkMoves a file into a picket. For a file that is already there the palette answers that “report.pdf” is already in “Work”, and a move that cannot happen answers “Could not move …”; neither adds a step to undo.
remind report.pdf 2hSets a reminder — durations like 30m, 2h, 1d, 1d2h. One that would fall after the year 9999 is refused, and the palette says so.
new picket TaxesCreates a picket.
tag report.pdf greenTags a file (red / orange / yellow / green / blue / purple; none clears).
go WorkFocuses that picket (unrolling it if rolled up). A picket hidden by any mode stays hidden — the palette says so instead. A tab is shown in the picket that holds it, which is the one focused, unrolled or reported hidden.
pin WorkPins / unpins a picket (ignores hide-all).
rollup Work · rollup allRolls a picket (or every picket) up or back down.
sort Work by sizeSorts a picket — name, type, date, size, usage, manual. Add asc or desc to set the direction (sort Work by date asc is oldest first); manual order has none.
page GamingSwitches to a saved page (a pre-change snapshot is taken first).
snapshotSaves a layout snapshot into the time machine.
organizeRuns an organize sweep now.
undoUndoes the last Picketdesk batch — the same 20-step stack Ctrl+Z and the tray use, reachable with nothing focused. Answers “Nothing to undo” on an empty stack.
focusToggles Focus mode.

Picket and page names resolve fuzzily (exact beats prefix beats substring), and while you type one the overlay offers matching titles — Tab accepts the first suggestion. move, tag and remind never find a file in a private picket — the palette has no Windows Hello prompt, so they answer “No item matching …” as if it were not there.

Inbox triage

The overlay's Inbox button lists the files that arrived since your last cleanup — the newest 60 desktop files created or modified (a file copied onto the desktop counts from the copy) since you last pressed Done — mark all triaged or Reset marker to now (both set the marker to now) — triaged entirely from the keyboard:

KeyAction
1–9File into one of your first nine regular pickets, in list order (portals, smart pickets, action zones and tabs are not numbered): the number-row key marked with the digit, with or without Shift (an AZERTY keyboard needs no Shift), or the keypad with Num Lock on.
RRemind me tomorrow.
DelRecycle.
EnterOpen.
SSkip.

“Done” marks everything triaged. The digits, R and S are single keys: held with Ctrl, Alt or the Windows key they do nothing. The keys act on the highlighted row, never through a button: with “Done” or “Reset marker” reached by Tab, Enter presses that button and the triage keys wait until focus is back on the list (Esc still leaves triage). One key at a time: a key pressed while the last one's file is still being filed, reminded or recycled is ignored, so it never acts on that same file twice. A filing refusal keeps the row available and reports why; only a confirmed filing removes it. A Del that recycled nothing (a No to Windows' own confirmation, a locked file) leaves the file listed and highlighted; a file already deleted outside Picketdesk leaves the list.

Reminders

The overlay's Reminders button lists every reminder you have set — the ones that have already gone off first, each group oldest first. A reminder is no longer thrown away the moment it fires: it keeps its ⏰ badge on the item and waits here until you deal with it, with Open, +1h, Tomorrow (both measured from now, not from when it was due) and Clear on each row. ↑↓ picks, Enter opens, Del clears, Esc goes back — on a row's button reached by Tab, Enter presses that button instead, and a mouse click on one leaves the keys with the list. The button turns amber while anything is waiting.

Settings → Export reminders (.ics) writes pending reminders to a new calendar file, preserving any existing export. Calendar identities survive rescheduling, file renames and restarts. Older reminders receive saved identities on their first export; a failed workspace save stops the export so a later restart cannot forget them.

This is the surface that always works. The Windows notification a due reminder posts stays in Action Center, but Windows gives Picketdesk no way to hear a click on it, so nothing about it is actionable.

The index

What image search leaves on disk Nothing an OCR search reads leaves your PC — but so each image is only recognised once, the text it found is kept in ocr-cache.json in the machine-local cache folder, %LOCALAPPDATA%\com.picketdesk.app — never beside a workspace that cloud sync or a redirect shares between PCs (an older build kept it there; that copy is moved at launch). That is a plain-text record of every screenshot a content search has opened. It is capped at 2,000 images and drops entries for images you delete, and Settings → Search text inside images (OCR) — on by default — skips the pass and deletes the file when you untick it. Older queued or running searches cannot recreate it; turning OCR back on permits new searches. Startup and a backup or snapshot with OCR disabled also clear the transcript. An ordinary page change preserves preferences saved while that page was loading.
Content-search coverage -c covers text formats, PDF, .docx (body, headers, footers and footnotes), .xlsx (cell text), .pptx (slide text), and image OCR. The pre-2007 .doc/.xls/.ppt formats are not covered, and a formula’s computed result is not text Excel stored, so it is not searched either.