Skip to main content

scopes

System folders (uncategorized, global) are marked; descriptions print next to their folder. See Scopes for what a folder means to recall.

scopes add

Missing parents are created. The description is not decoration: the classifier reads it when filing unscoped saves, so a described folder collects better.

scopes rename, describe, move, rm

Folders address by path or id. rm refuses a folder that still has subfolders, memories, or documents; empty it first with scopes set. System folders refuse rename, move, and delete.

scopes set, set-doc

set moves whole version chains, so history never straddles two folders. set-doc moves a document and every chunk in one transaction.

scopes backfill

Files every unfiled memory whose import provenance names a project into projects/<name>, deterministically and without a model call. It never overrides a filing you made by hand, re-running it is a no-op, and what it files the classifier skips forever. The remainder (saves with no provenance) goes through the same classification pass an index run uses; without --no-llm the command runs one for you. Run --dry-run first: it prints exactly what the real run would do.

scopes review

The correction loop after a backfill or a classification pass: list a folder, spot the misfiled, move them with scopes set. The viewer’s folder sidebar is the same loop with multi-select.

Filing and filtering elsewhere

A scoped recall searches the subtree plus uncategorized and global; browsing and set touch just the folder you name.