Nestr Basics

nestr is a fast, composable CLI for Nestr. Everything in Nestr is a Nest, and what a nest is is set by a single prime label (project, goal, role, …) — a nest with no prime label is a plain todo, labelled task. Pick a profile once (nestr profiles add), then work the loop below. Add -o json to any command for raw JSON to pipe to jq. Full setup, global flags, and the command map: shared/reference.md.

Find things

nestr search "quarterly review"          # search the active workspace
nestr search "bug" --in <nestId>         # search within a nest subtree
nestr nests get <id>                     # read one nest (or several: id1,id2)
nestr nests children <id>                # list a nest's children