Command uninstall and purge

Commands: uninstall & purge

Two irreversible maintenance commands. Both are gated: on a TTY they prompt for confirmation; when scripted (non-TTY) they require --yes (or --force) or refuse. Each names exactly what it removes and suggests exporting first — run export before either.

uninstall

columbus uninstall [--yes]

Removes Columbus from the project entirely: deletes .columbus.json and the whole project data directory (database, logs, exports). The repo's source is untouched.

$ columbus uninstall --yes
uninstalled columbus project proj_2fd171eebe922fad
  removed config: /your/project/.columbus.json
  removed data:   ~/Library/Application Support/columbus/projects/proj_…

purge

columbus purge [--yes]

Clears all records from the database and resets .columbus.json to defaults, keeping the project alive (same project_id). Files stay; data is gone. Re-run columbus reindex to rebuild the index afterward.

$ columbus purge --yes
purged all data for project proj_2fd171eebe922fad
  fresh db:  ~/Library/Application Support/columbus/projects/proj_…/columbus.sqlite
  config reset to defaults

Refusing without confirmation

$ columbus purge          # non-TTY, no --yes
error [USAGE]: About to erase all records in … — this is irreversible;
re-run with --yes to confirm (export first with `columbus export`)

Exit codes

0 success · 2 usage (no confirmation / aborted) · 3 not initialized. See Exit Codes.

See also

Command: install · Command: import & export