Nestr Insights, Graph & Export

Three ways to see across a Nestr workspace: graph links connect nests, insights report metrics over time, and export dumps whole trees as JSON.

First run nestr profiles add (OAuth or API key) — a profile pairs a workspace with an identity. Global flags on every command: -p/--profile, -o text|json, --read-only (block writes), and --yes (skip write confirmations; required for agents). Full setup, env overrides, and the command map: shared/reference.md.

Relate nests (graph links)

Links are directed and grouped by a free-text relation (e.g. meeting). A link runs from a source nest to a target; the target lists it as incoming. Argument order is the direction, so links add A rel B and links add B rel A are different links, and links remove only removes the one in the order you give.