Skip to content
Hansardhansard

Configuration

Hansard stores machine preferences in config.json. Use the configuration CLI instead of editing that file directly so values are normalized consistently.

Use Settings in the app

Section titled “Use Settings in the app”

Open Settings from the bottom of the app sidebar. Its search field finds a visible setting by name, while the section list separates personal display preferences from workflows, connections, and system configuration:

  • General, Lists, and Appearance control identity, local agent-session messaging, and presentation.
  • Classification, Handoff, and Indexing & Imports control agent-work workflows and local capture.
  • Notifications, Slack, Personal Sync, and Teams manage local or outbound connections with their boundary warnings beside the controls.
  • Projects, Portfolios, and Privacy & Sharing organize the archive and summarize outbound state.
  • About shows the running version and update status.

Settings writes normalized values through the same configuration layer as the CLI. Use the terminal for scripted changes, exact key inspection, secret reveal, and advanced values that have no app control; a missing Settings field is not permission to edit config.json by hand.

Inspect configuration

Section titled “Inspect configuration”
Terminal window
hansard config show
hansard config show --json
hansard config path
hansard config get storage.root

Secret values are masked by default. hansard config get <key> --reveal prints a raw value for scripts and should be used only when terminal output is trusted.

Update one value

Section titled “Update one value”
Terminal window
hansard config set imports.defaultSinceDays 90
hansard config set sync.intervalMinutes manual
hansard config set index.paused true
hansard config unset notify.slack.botToken

Values that parse as JSON, booleans, or numbers retain those types. Other values are stored as strings.

Reopen setup preferences

Section titled “Reopen setup preferences”

config setup revisits the preference-oriented parts of initialization without running an import:

Terminal window
hansard config setup
hansard config setup --watch-sources codex-cli,cursor --default-since-days 90
hansard config setup --sync-interval-minutes manual --no-autostart

Manage source lists

Section titled “Manage source lists”
Terminal window
hansard config sources edit

Saved source state has three parts: historical backfill sources, live watcher sources, and deferred history. set replaces only the watcher list and preserves the saved backfill choices. enable adds a source to backfill and watching; disable removes it from both. defer retains forward watching but removes the source from default hansard import --source all backfills. reset clears deferrals, restores defaults, and enables automatic future-source discovery. An explicit --source ... or --sources ... selection overrides saved choices for one import run only. add and remove remain compatibility aliases for enable and disable.