Skip to content

Command import export

Rafael Fragoso edited this page Jun 8, 2026 · 1 revision

Commands: import & export

Move a project's durable knowledge in and out as a portable JSON document — memories, epics, stories, tasks, tags and references. Vectors are not included; columbus reindex rebuilds them.

export

columbus export [--out FILE]

Writes the full knowledge document to stdout (or --out FILE). The document is schema-versioned and round-trips with import.

$ columbus export --out knowledge.json
exported 12 knowledge entities to knowledge.json

import

columbus import [PATH] [--preserve-ids]

Reads a knowledge document from PATH (or stdin) and inserts it.

Flag Description
--preserve-ids Restore original ids (errors on collision); default reassigns
$ columbus import knowledge.json
imported 12, skipped 0 of 12 (reassigned ids)

Older v2 documents (no story tier) import cleanly: their tasks are repointed to a synthesized General story per epic.

Exit codes

0 success · 2 usage (invalid document) · 3 not initialized. See Exit Codes.

See also

Project Memory · Command: memory · Command: reindex

Clone this wiki locally