Skip to content

replay

Build the entity-level city replay of a temporal store.

Synopsis

codegraph replay [--store FILE] [--name STR] [--history FILE] [--out FILE] [--serve] [--port N] [--host ADDR]

Options

OptionMeaningDefault
--store FILEThe temporal model.db (built by codegraph snapshots or import --at); defaults to the store beside this directory’s default model.—
--name STRCorpus display name; defaults to the store’s basename.—
--history FILEA history.jsonl (codegraph scm) to join by path suffix: buildings gain their file’s dominant author, and co-change arcs (logical coupling, default thresholds) join the replay.—
--out FILEWrite the laid-out replay city artifact here instead of stdout.—
--serveServe the replay in the visualizer — a timeline scrubs the revisions (stdout stays empty; Ctrl-C stops it).—
--port NPort for –serve; 0 picks a free one.4177
--host ADDRInterface for –serve to bind; 127.0.0.1 keeps the replay on this machine only.0.0.0.0
-h, --helpShow this help.—

Exit codes

0 ok · 1 internal error (a bug) · 2 usage error · 3 findings.

3 is not returned.

Example

$ codegraph replay --store /tmp/temporal.db --out /tmp/replay.json
replay city of /tmp/temporal.db: 3 districts, 19 buildings, 1 revision on the timeline.
wrote 16806 bytes to /tmp/replay.json.

See also

city.json · CLI conventions

Last updated on