CLI

Interactive Mode

Run noum with no arguments for a menu-driven TUI. Commands are grouped by category, repositories and ask sessions come from live data, and there's nothing to memorize.

noum

Tab through the menu, pick a command, and supply parameters from selectable lists. Useful when you're exploring; the same actions are available as direct flags for scripts.

Pipeline Selectors

Pipeline commands (analyze, enrich, update, digest) accept selectors to scope the work to a subset of the repo:

• --path src/foo — only files under that directory.
• --include "src/**/*.clj" — glob whitelist.
• --exclude "**/*_test.clj" — glob blacklist.
• --lang clojure — restrict to a single language.

noum analyze ./my-repo --include "src/**/*.clj" --exclude "**/*_test.clj"

Branches and Federation

Experimental — interfaces may change between releases. When the active connection is hosted and your local git rev-parse HEAD has diverged from the trunk DB's stored basis, noum query automatically materializes a sparse local delta DB at ~/.noumenon/deltas/ and routes the named query through /api/query-federated. A one-line yellow banner — Federating against local delta @<basis7>… — makes the rerouting observable. Disable per-call with --no-auto-federate or persistently with noum settings federation/auto-route false.

Explicit form (still works): noum query <name> <repo> --federate --basis-sha <sha>. Materialize the delta directly with noum delta-ensure <repo> --basis-sha <sha>; GC orphan deltas with bb prune-deltas from the noumenon source tree.

Drift Handling

When you change a prompt template or switch LLM models, prior analysis results are still valid until you decide otherwise. Drift is advisory: Noumenon logs which files were analyzed with a different prompt or model, but only re-analyzes them when you ask. Pass --reanalyze prompt-changed or --reanalyze model-changed (or stale, or all) to refresh.