Commands

Commands

research-diff [--repo PATH] [--config FILE] COMMAND (also resdiff).

• map [--at REF|.] [--out DIR] [--check]: research.json and research.svg of the working tree (default) or a commit.
• diff [--base checkpoint|REF] [--head .|REF] [--out DIR]: what changed, as headline.txt, plan.txt, diff.svg and diff.json. Defaults: from the checkpoint to the working tree.
• checkpoint [--ref REF]: mark the working tree (or REF) as understood. It is kept under refs/research-diff/checkpoint, in your clone only. Before the first checkpoint, the diff starts from HEAD.
• watch [--port 8766]: a live page of the diff since the checkpoint, with Mark as seen.
• readme [--check]: rewrites the README section between <!-- research-map:begin --> and <!-- research-map:end -->, and its picture.
• setup claude [--scope user|project|local] [--undo], hook, mcp: see With AI coding agents.

The working tree is read as a snapshot: untracked files count, and nothing you use changes (not your index, HEAD or branches).