Command graphs

Command: graphs

Project the indexed file dependency graph (nodes + edges). Replaces the former show graph subcommand.

Synopsis

columbus graphs [flags]

Description

A pure read over the indexed cache: file nodes (id = path) and external package nodes (id = ext:<pkg>), connected by directed import / test / external edges. No live re-resolution. Narrow and bound it with the flags below.

Flags

Flag	Default	Description
--in string	—	Keep files whose path contains this substring
--role string	—	Keep files with this role (impl, test, …)
--lang string	—	Keep files with this language
--max int	200	Cap the number of file nodes
--depth int	0	Graph traversal depth (global flag; 0 = direct edges)

Plus global flags (--json, --llm, --no-color).

Examples

$ columbus graphs --role impl --in internal/store    # induce a subgraph

$ columbus graphs --json
{"nodes":[…],"edges":[{"from":"src/index.ts","to":"src/server.ts","type":"import"}],
 "freshness":{"indexed_head":"c3035af…","dirty":false,"stale":false},"total":4,"ok":true}

Exit codes

0 success · 3 not initialized / index missing. See Exit Codes.

See also

Navigating Code · Command: show · Command: search