Command show

Command: show

Show a symbol, file, memory, epic, or task in detail. For the dependency graph, see Command: graphs.

Synopsis

columbus show <subcommand> [args] [flags]

Subcommands

Subcommand	Shows
symbol <name>	All definitions of a symbol (full body, exact ranges)
file <path>	A file's outline and graph (imports / imported-by)
memory <id>	A memory by id (mem_NNN)
epic <id>	An epic: fields, refs, history, child stories & tasks
task <id>	A task: fields, refs, history

Common flag: --in <path> narrows symbol to a directory. Plus global flags.

Examples

$ columbus show symbol parseConfig
1 definition(s) of "parseConfig"

1. parseConfig [function]  src/config.ts:4-6
   | export type Config = { port: number; host: string };
   | …
   | export function parseConfig(env: Record<string, string>): Config {
   |   return { port: Number(env.PORT ?? 8080), host: env.HOST ?? "localhost" };
   | }

$ columbus show file src/server.ts
src/server.ts  [typescript, package , impl]
outline (4 symbols):
     3  class     Server
     4  method    Server.constructor
     5  method    Server.start
     8  function  newServer
imports: src/config.ts
imported by: src/index.ts

Snippets and ranges are reconstructed live from the working tree — they are never stale (see Never Stale: Live Reconstruction).

show file | symbol | memory also lists, in reverse, the epics, stories and tasks that reference that entity. For the whole dependency graph as {nodes, edges}, use graphs.

Exit codes

0 success · 1 not found (e.g. unknown symbol) · 3 not initialized. See Exit Codes.

See also

Navigating Code · Command: search · Command: graphs