Reference

memex show

Read one thing’s intent, then walk its trail: what it cites and what cites it.

What it does

Takes one or more paths or refs. A file prints its header, what it cites (each with its target’s one-liner), who cites it, and the READMEs above it, nearest first. A folder prints its README, then lists its children with their one-liners.

Nobody maintains a link table: citations come from the ids, paths and refs people already write, and are read in both directions. Every label it prints is valid input to show.

Flags

--up N: How many READMEs of the chain to print; --up 0 prints the file alone.
--comments: Also prints the file’s other comment blocks, after the header.
--limit N: Caps the children and cited-by lists.
--json: One JSON document per call, errors included.

A file, one README up

repo

$ memex show crates/namer/src/hash.rs --up 1
=== crates/namer/src/hash.rs ===
FNV-1a over canonical atom strings.
Cases: NAME-001

cites
  cases:NAME-001  Class names are stable across runs and platforms.

cited by
  crates/namer/README.md  Namer: turns atoms into stable class names.
  impl:20261013-214107-show-walks-hub-readmes  show walks hub READMEs
  showing 2 of 2

chain
--- crates/namer/README.md
# Namer

Namer: turns atoms into stable class names. See `src/hash.rs` and NAME-001.

← All verbs