# CLI commands > Every top-level hansard command, grouped by task, with a link to the guide that covers it. The `hansard` CLI covers everything the app does plus setup, maintenance, and automation. Print the full usage for any command with `hansard help ` or `hansard --help`. `hansard --version` prints the installed version. Most commands accept `--json` for scripts. Commands that write or delete data accept `--dry-run` to preview and `--yes` to skip confirmation. ## Interactive mode and Tab completion Run `hansard` with no command in a terminal to open the interactive mode. As you type, a list shows the matching subcommands, flags, and values, such as import sources, archived conversations, import runs, accounts, and config keys. Tab completes the highlighted entry, Up and Down choose another, Enter runs the command, and Ctrl-D on an empty line leaves. With nothing typed, Tab lists the commands grouped by task, under the same headings as `hansard help`. Each command runs as its own process, and the prompt returns when it finishes. Scripts, pipes, and agent shells still get the command list from a bare `hansard`. To print the list in a terminal too, turn the prompt off with `hansard config set cli.interactive false`, or uncheck it when `hansard init` asks. `HANSARD_INTERACTIVE=0` disables it for one process. The same lists work with Tab in bash, zsh, and fish: ```sh eval "$(hansard completion zsh)" # in ~/.zshrc, after compinit eval "$(hansard completion bash)" # in ~/.bashrc, or ~/.bash_profile on macOS hansard completion fish > ~/.config/fish/completions/hansard.fish ``` `hansard help completion` covers every key and the faster ways to install the shell scripts. ## Set up and open | Command | What it does | Guide | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | `hansard init` | Configure storage, sources, redaction, the watcher, and integrations, then optionally import history. `--since 30d` selects the initial history window. `--dry-run` previews; `--status` shows an unfinished setup. | [Install the CLI](https://www.hansard.dev/getting-started/installation/) | | `hansard app` | Open the Mac app. `hansard app install` installs or replaces it; `--no-fallback` only opens an installed app. `hansard app processes` lists the processes that run from the app and the agent runs each one owns. | [Install the Mac app](https://www.hansard.dev/getting-started/download/) | | `hansard web` | Serve the app in a browser at `127.0.0.1:7824`. | [Browse conversations](https://www.hansard.dev/guides/browse-conversations/), [Hosted viewer](https://www.hansard.dev/sync/hosted-viewer/) | | `hansard status` | Show the watcher, archive, sync, index, plan usage, and recent imports. | [Maintenance](https://www.hansard.dev/reference/maintenance/) | | `hansard doctor` | Check dependencies, sources, and setup. `--deep` audits the whole archive. `doctor records` lists the record types each source holds and any an importer does not recognize. | [Maintenance](https://www.hansard.dev/reference/maintenance/), [Transcript records](https://www.hansard.dev/reference/transcript-records/) | | `hansard whats-new` | Show what is new in this version and run its setup steps. `--list` shows bundled releases; a version previews another. | [Maintenance](https://www.hansard.dev/reference/maintenance/) | | `hansard config` | Show or change settings. `config setup` reopens setup choices; `config sources` manages sources. | [Configuration](https://www.hansard.dev/reference/configuration/) | ## Import history | Command | What it does | Guide | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | `hansard import --source ` | Import one local source. `--sources a,b,c` imports several; `--source all` imports the configured list. | [Supported harnesses](https://www.hansard.dev/imports/supported-sources/) | | `hansard import status\|follow\|pause\|resume\|cancel\|retry\|skip\|forget` | Inspect and control import runs, including runs started with `--background`. | [Supported harnesses](https://www.hansard.dev/imports/supported-sources/) | | `hansard import chatgpt\|claude-web\|gemini-web [path]` | Import a ChatGPT, Claude.ai, or Gemini export, with a guided walkthrough when you omit the path. | [Web exports](https://www.hansard.dev/imports/web-exports/) | | `hansard import claude-cloud\|claude-cowork-cloud\|codex-cloud\|copilot-agent-cloud\|amp-cloud\|augment-cloud\|devin-cloud\|jules\|cursor-cloud\|factory-cloud\|openhands-cloud\|warp-cloud\|kilo-code-cloud\|qoder-cloud` | Import cloud sessions with read-only requests. These never run as part of `--source all`; **Settings → Imports → Cloud agents** keeps them current instead. | [Supported harnesses](https://www.hansard.dev/imports/supported-sources/#import-cloud-sources-and-exports) | | `hansard import notebooklm ` | Import a NotebookLM Takeout export. | [NotebookLM](https://www.hansard.dev/imports/notebooklm/) | | `hansard import muse-agent ` | Import a Muse (Personal Agent) agent data export. | [Web exports](https://www.hansard.dev/imports/web-exports/#muse-personal-agent) | | `hansard import qwen-chat ` | Import one Qwen Chat chat downloaded as JSON. A new account needs `--username `. | [Web exports](https://www.hansard.dev/imports/web-exports/#qwen-chat) | | `hansard browser serve\|pair\|status\|revoke\|retry` | Run the receiver for the browser extension, pair a browser, and inspect or retry its captures. | [Browser conversation capture](https://www.hansard.dev/imports/browser-capture/) | | `hansard import windsurf` | Recover trajectories from a running Windsurf app, or import downloaded trajectory Markdown. | [Windsurf](https://www.hansard.dev/imports/windsurf/) | | `hansard import accounts list\|rename\|link` | List, rename, or link ChatGPT, Claude.ai, and Gemini export accounts. | [Web exports](https://www.hansard.dev/imports/web-exports/) | | `hansard import ledger` | Show the file and session deduplication ledger. | | | `hansard watcher start\|stop\|restart\|adopt\|status\|logs` | Manage the background watcher. `watcher adopt` moves it, and login startup when on, to the copy that runs the command. `watcher login enable\|disable\|status` manages starting it at login. | [Background archiving](https://www.hansard.dev/imports/watcher/) | ## Browse, search, and analyze | Command | What it does | Guide | | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- | | `hansard history [query]` | List or search conversations, filtered by project, folder, harness, tool, command, edited file, commit, or time. | [Search](https://www.hansard.dev/guides/search/) | | `hansard show ` | Print, open, or render one conversation as JSON. `--unredacted` prints the messages as they were before redaction, rebuilt from the archived transcript and the originals the local reveal cache keeps. | [Browse conversations](https://www.hansard.dev/guides/browse-conversations/) | | `hansard show --continuation` | Prepare context for continuing a conversation on this device. | [Continue](https://www.hansard.dev/guides/continue/) | | `hansard show --agents` | List the agents a conversation started, as its **Agents** view does, with each one's start, duration, state, harness, model, task, result, and cost. | [Browse conversations](https://www.hansard.dev/guides/browse-conversations/) | | `hansard rename ` | Name a conversation, as renaming it in the viewer does. `--clear` brings its own title back. | [Browse conversations](https://www.hansard.dev/guides/browse-conversations/) | | `hansard summaries status\|run\|show` | Summarize ended conversations, so you can continue one from its summary. Off until you turn on `summaries.enabled`; `run` summarizes older conversations on request. | [Continue](https://www.hansard.dev/guides/continue/#continue-from-a-summary) | | `hansard why :` | Find the archived agent edit that wrote a line, with the session, the prompt before the edit, and the commit that last changed it. | [Search](https://www.hansard.dev/guides/search/#find-the-conversation-that-wrote-a-line) | | `hansard why ` | Read a file's history: the sessions that edited it, newest first, with commits, reverts, and test failures and fixes. | [Search](https://www.hansard.dev/guides/search/#read-a-files-history-and-a-tasks-context) | | `hansard work-context [session-id]` | Read the task a conversation belongs to: its sessions in order, recorded steps, outcomes, and linked conversations. | [Search](https://www.hansard.dev/guides/search/#read-a-files-history-and-a-tasks-context) | | `hansard experience status\|rebuild` | Show or rebuild the experience index behind file history: edits, commits, reverts, and test failures with the runs that fixed them. The watcher keeps the last 30 days current; `rebuild` indexes every conversation, or one repository with `--repo`. | [Search](https://www.hansard.dev/guides/search/#read-a-files-history-and-a-tasks-context) | | `hansard embeddings enable\|status\|search\|similar\|subjects\|disable` | Turn on search by meaning with a local embedding model, search conversations and screenshots by meaning, and list similar conversations. | [Search](https://www.hansard.dev/guides/search/#search-by-meaning) | | `hansard deep-recall ` | Research a question across full conversations with the Codex or Claude CLI and return a cited answer. | [Deep Recall](https://www.hansard.dev/guides/deep-recall/) | | `hansard stats` | Summarize activity, models, tokens, spend estimates, tools, commands, skills, and MCP servers. `--team` scopes it to one joined Team, `stats teams` lists them, and `stats totals` reads a range of days from the day rollups. | [Stats](https://www.hansard.dev/guides/stats/) | | `hansard behavior` | Compare one period of activity with the period before it. | [Compare periods](https://www.hansard.dev/guides/behavior/) | | `hansard classify` | Label conversations by work mode and outcome: status, automatic passes, explicit runs, and stored results. | [Classification](https://www.hansard.dev/guides/classification/) | | `hansard permissions suggest` | Suggest Claude Code `Bash(...)` allow rules from archived shell commands. | [Permissions](https://www.hansard.dev/guides/permissions/) | ## Memories and skills | Command | What it does | Guide | | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | | `hansard memory backup\|search\|list\|show\|duplicates\|export` | Back up harness memory files, browse, search, or export the memory archive, and list memories from different providers that cover the same subject. | [Memories](https://www.hansard.dev/guides/memories/) | | `hansard memory import chatgpt ` | Import memories copied from ChatGPT's memory settings. | [Memories](https://www.hansard.dev/guides/memories/) | | `hansard skills backup\|list\|history\|show\|failures` | Capture skill revisions and inspect skill loading failures. | [Skills and MCPs](https://www.hansard.dev/guides/skills-and-mcps/) | | `hansard library list\|search\|show\|add\|keep\|edit\|remove\|open\|import\|collect` | Keep and reuse scripts, components, pages, and snippets agents make: sort and group found items, keep several at once into a bucket, and edit titles. | [Library](https://www.hansard.dev/guides/library/) | | `hansard eval import\|list\|show` | Archive and inspect existing Claude plugin evaluation results. | [Skills and MCPs](https://www.hansard.dev/guides/skills-and-mcps/) | | `hansard bridge list\|on\|off\|tool\|approvals\|pending\|load\|stop\|status` | Share other agents' skills, MCP servers, and plugins with every agent, and choose what each tool may do. | [Skills and MCPs](https://www.hansard.dev/guides/skills-and-mcps/) | ## Agents and accounts | Command | What it does | Guide | | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | `hansard integrations recall\|add-to\|status\|sync\|forget` | Install recall commands, skills, and MCP entries in your agents, and keep them in place. | [Recall in your agents](https://www.hansard.dev/guides/agent-integrations/) | | `hansard mcp serve` | Run conversation and memory retrieval over standard input and output. `--no-memories` omits memory tools; `--messaging` and `--delegation` add tools. | [Recall in your agents](https://www.hansard.dev/guides/agent-integrations/) | | `hansard boards` | Discover automatic cross-project, project, and portfolio boards; create channels, post and read threads, search, and subscribe. | [Discussion boards](https://www.hansard.dev/guides/session-messaging/#project-boards-and-shared-topics) | | `hansard peers` | Set up and use messaging between live Codex and Claude Code sessions: `setup`, `status`, `list`, `send`, `ask`, `reply`, `inbox`, `read`, `mute`, `unmute`, `retry`. | [Agent messaging](https://www.hansard.dev/guides/session-messaging/) | | `hansard agents` | Set up and manage helper sessions across harnesses: `setup`, `status`, `targets`, `list`, `spawn`, `wait`, `message`, `cancel`. | [Helper agents](https://www.hansard.dev/guides/agent-delegation/) | | `hansard ps` | List the agent harnesses running on this computer with their state, CPU, and memory. Each agent lists its subagents, and agents paused from Running follow. `--watch` opens a full-screen monitor, `ps stop ` or `ps stop --idle` stops agents, and `ps pause `, `ps resume `, and `ps evict ` pause, resume, and remove them as Running does. | [Running agents](https://www.hansard.dev/guides/running-agents/) | | `hansard coordinator status\|start\|resume\|send` | Start, resume, and message visible agents in a project, and keep its roster, decisions, follow-ups, workstreams, and watches. `status` shows each agent's state, tokens, and estimated cost. `start --in` chooses where an agent opens: a cmux, Terminal, iTerm, or Ghostty tab, or the app. `start --environment` starts it in a project environment. | [Projects and coordinators](https://www.hansard.dev/guides/projects/#start-and-message-the-projects-agents) | | `hansard projects list\|show\|plan\|plugins\|add\|dismiss\|hide\|restore\|share\|shared\|bind` | List organizations, projects, and their environments, add or hide projects, share them with your Teams, and plan a launch in an environment without starting it. `bind` sets where an environment's folder is on this device. | [Projects and coordinators](https://www.hansard.dev/guides/projects/#manage-projects-from-the-cli) | | `hansard account` | Manage harness sign-in profiles, browser profiles, plan usage capture, plan value estimates, account pools, and the local request router and its temporary overrides. `account retire ` takes an account you no longer use out of routing and usage checks, and `account restore` brings it back. `account status` shows each account's logins and router copies with the reason for every state. | [Accounts and plan usage](https://www.hansard.dev/guides/account-authentication/) | | `hansard dictation [status]\|setup` | Show or set up the engines that transcribe composer dictation. | [Dictation](https://www.hansard.dev/guides/dictation/) | | `hansard remote` | Run agents on your other computers: set up a host, pair or add devices, and list, check, or remove them. `remote devices` shows each paired device's state, version, ready agents, and projects, `remote check` runs the quick check, and `remote follow` reads a run. `hansard remote host stop` stops a running host. | [Continue](https://www.hansard.dev/guides/continue/#run-agents-on-your-other-computers) | ## Sync and share | Command | What it does | Guide | | | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | | `hansard personal-sync create\|connect\|status\|remove` | Create, join, inspect, or leave a Personal Sync space. | [Personal Sync](https://www.hansard.dev/sync/personal-sync/) | | | `hansard personal-sync auth\|accounts` | Sign in to Google Drive, OneDrive, or Dropbox with your own OAuth app, and list the connected accounts. | [Personal Sync](https://www.hansard.dev/sync/personal-sync/#google-drive-onedrive-and-dropbox) | | | `hansard personal-sync storage add\|list\|sync\|remove` | Keep up to 16 additional storage copies of the Personal Sync backup. | [Personal Sync](https://www.hansard.dev/sync/personal-sync/#keep-redundant-storage-copies) | | | `hansard personal-sync devices\|state\|link-projects` | Review other devices with their health warnings, synced settings, and cross-device project merges. | | | | `hansard personal-sync cloud-accounts [owner]` | See which device captures each cloud account, and choose another. | [Personal Sync](https://www.hansard.dev/sync/personal-sync/) | [Personal Sync](https://www.hansard.dev/sync/personal-sync/) | | `hansard personal-sync recover-head\|recover-capture\|interpret` | Recover an interrupted sync, or reparse one received Codex or Claude conversation locally. | [Personal Sync](https://www.hansard.dev/sync/personal-sync/) | | | `hansard personal-sync prune-remote` | Preview, and with `--yes` apply, the removal from the destination of superseded versions that only this computer uploaded. | [Personal Sync](https://www.hansard.dev/sync/personal-sync/) | | | `hansard team create\|preview\|join\|invite\|status\|purge-legacy-raw` | Create, preview, join, and inspect Teams, and clean up older Team destinations. | [Teams](https://www.hansard.dev/sync/teams/) | | | `hansard team rules\|accept\|scope\|sharing` | Review and accept a Team's changed rules, limit your uploads to chosen folders, and record your memory and agent-message choices. | [Teams](https://www.hansard.dev/sync/teams/#create-and-join-from-the-cli) | | | `hansard team storage add\|list\|sync\|remove` | Keep up to 16 additional storage copies of a Team. | [Teams](https://www.hansard.dev/sync/teams/#keep-redundant-storage-copies) | | | `hansard team devices\|network\|relay-allowlist\|presence\|requests` | Admit devices for agent messages, name the Team's relay, and choose what teammates see and how their agents' requests reach your sessions. | [Teams](https://www.hansard.dev/sync/teams/#let-agents-message-teammates) | | | `hansard storage offload\|restore` | Free local space by removing original files and attachments older than 30 days once two backup destinations hold verified copies, and bring them back. Both preview until `--yes`. | [Personal Sync](https://www.hansard.dev/sync/personal-sync/#offload-old-files-to-the-backup) | | | `hansard device status\|adopt\|sign-ins` | Settle a Hansard identity that a copy of another computer's home folder carried. | [Moving to a new Mac](https://www.hansard.dev/sync/new-computer/) | | | `hansard sync` | Run a sync pass now for the configured targets. `sync status` shows each target's last upload and receive; `sync receive` only downloads. | [Personal Sync](https://www.hansard.dev/sync/personal-sync/) | | | `hansard sync configure\|snapshot\|replace\|wipe` | Configure a generic remote target, upload a point-in-time snapshot, replace this device's remote copy, or delete remote objects by scope after a typed confirmation. Snapshot, replace, and wipe do not apply to current Personal Sync spaces. | | | | `hansard notify slack` | Set up Slack posting, routes, tokens, tests, and digests. `notify slack bot run` runs the interactive bot. | [Slack](https://www.hansard.dev/sync/slack/) | | | `hansard notify status\|test` | Show Hansard's notification kinds, destinations, and quiet hours on this computer, or send a test notification. | | | ## Privacy | Command | What it does | Guide | | ---------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------- | | `hansard redact status\|init\|enable\|disable\|test` | Configure and preview redaction rules. | [Redaction](https://www.hansard.dev/privacy/redaction/) | | `hansard redact reapply` | Rewrite archived conversations with the current rules. | [Redaction](https://www.hansard.dev/privacy/redaction/) | ## Maintain and recover | Command | What it does | Guide | | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | | `hansard index pause\|resume\|status\|rebuild` | Manage the local search index. | [Maintenance](https://www.hansard.dev/reference/maintenance/) | | `hansard rebuild` | Refresh stale views, events, titles, and tool usage from archived files. `--stale-parsers` rescans sources imported by an older parser; `--from-raw` reparses preserved original files; `--format 1\|2` converts conversations between archive formats; `--compact-raw` losslessly compresses the original harness files already in the archive. | [Maintenance](https://www.hansard.dev/reference/maintenance/) | | `hansard update` | Clear the local conversation archive and indexes, then reimport configured sources. Use only when [release notes](https://www.hansard.dev/releases/) require it. `--list-recoveries` and `--recover ` restore the archive after an interrupted update. | [Maintenance](https://www.hansard.dev/reference/maintenance/#recover-from-an-interrupted-update) | | `hansard restore-sources ` | Put preserved original files back where the harness expects them. Never overwrites existing files. | [Maintenance](https://www.hansard.dev/reference/maintenance/) | | `hansard repair claude-code-backups\|codex-subagent-prompts\|repo-keys` | Restore Claude Code files, recover encrypted Codex subagent messages through OpenAI, or re-file sessions whose repository changed. | [Maintenance](https://www.hansard.dev/reference/maintenance/) | | `hansard prune archive-objects\|sync-outbox\|received-history\|reveal-cache` | Reclaim space from unreferenced archive objects, finished upload payloads, superseded received history, and whole unredacted copies earlier versions kept. | [Maintenance](https://www.hansard.dev/reference/maintenance/) | | `hansard export ` | Copy one conversation's files out of the archive. `--include-raw` adds the original harness files. `--format atif\|eatif\|html\|markdown` writes one trajectory or readable file instead. | [Share a conversation](https://www.hansard.dev/guides/share-conversations/) | | `hansard delete ` | Remove Hansard's copy of one conversation, and a day later its Personal Sync backup copy. The harness's history is untouched. | [Maintenance](https://www.hansard.dev/reference/maintenance/) | | `hansard reset` | Remove Hansard's local state and archive for a fresh setup. | [Maintenance](https://www.hansard.dev/reference/maintenance/) | | `hansard uninstall` | Stop the watcher and login item and optionally remove local data. | [Maintenance](https://www.hansard.dev/reference/maintenance/) | ## Aliases These older names still work and print the current command name. | Alias | Current command | | ----------------------------------------------------------- | ---------------------------------------------------- | | `hansard start`, `stop`, `logs` | `hansard watcher start`, `stop`, `logs` | | `hansard autostart` | `hansard watcher login` | | `hansard migrate` | `hansard sync configure` | | `hansard snapshot` | `hansard sync snapshot` | | `hansard clear` | `hansard reset` | | `hansard upgrade` | `hansard update` | | `hansard reveal ` | `hansard show --unredacted` | | `hansard accounts` | `hansard import accounts` | | `hansard memories` | `hansard memory` | | `hansard server`, `hansard recall start` | `hansard mcp serve` | | `hansard recall add-to`, `install-skill`, `install-command` | `hansard integrations add-to`, `integrations recall` | | `hansard recall show`, `recall reindex` | `hansard show`, `hansard index rebuild` | | `hansard prune raw-sources` | `hansard prune archive-objects` | ## Common options Options apply only to commands that list them in `hansard help `. | Option | Meaning | | ----------------------------- | ----------------------------------------------------------------------------------------- | | `--json` | Print machine-readable output. Prefer it in scripts; the plain output can change. | | `--since 30d\|90d\|180d\|all` | Limit the time window. Import also accepts hours (`12h`), minutes (`60m`), and ISO dates. | | `--source ` | Choose one import source, such as `codex-cli` or `cursor`. | | `--sources a,b,c` | Choose several import sources for one run. | | `--repo ` | Filter by repository, scope, working directory, or displayed path. | | `--provider ` | Filter by harness or source alias. | | `--tool ` | Filter by tool name. | | `--command ` | Filter by shell command, such as `"git commit"`. | | `--file ` | Filter by an edited file path (case-insensitive substring). | | `--commit ` | Filter by a recorded Git commit (7 to 40 hex characters, prefix match). | | `--dry-run` | Preview writes or deletions without making them. | | `--yes` | Skip the confirmation prompt. |