Upgrade notes
All releasesUpgrading across several releases applies each release's notes, oldest first.
0.8.0
- Update every Hansard copy that shares an archive, including the desktop app and npm installation, and update each Personal Sync device. The coordinator workbench store moves to writer and reader version 2, so earlier copies leave it unopened instead of resuming conversations without their account placement. Router API accounts use writer version 6 and require reader version 5, which records spending consent, or reader version 6 once the store holds an OpenRouter, Bedrock, or Vertex AI key, so earlier copies cannot read an API account store this release saved. The plugin bridge’s switch store moves to writer and reader version 2, so an earlier copy keeps the switches it last loaded and, once restarted, serves no bridged tools until it is updated. Helper records with account placement or startup retries require reader version 5. Library collection state requires reader version 5, so an earlier copy stops collecting into the Library. The add-on record moves to version 2 with reader floor 1 for hosted add-ons, which a copy that reads only version 1 leaves out and never rewrites. Integration state uses writer version 5 with reader floor 2, and earlier copies read it without rewriting it. The Library catalog uses writer version 5, playbooks with exemplar links require reader version 2, and playbook proposals with an exemplar require dreaming record reader version 3. Streamed import state moves to version 2 and starts again on its own. A project merge that adds a folder family syncs as project merge schema 2, which earlier copies carry without applying. These changes need no complete archive reimport.
- A person’s Personal Sync devices now update to one release. When another
device in the same Personal Sync profile reported a newer release in the
last three days, and the update feed or npm already lists that release for
this platform, the desktop app opens an Update required sheet.
Update and restart runs the in-app updater, and while tasks run,
Update when they finish waits for them without stopping any. On an npm
installation,
hansard status,hansard doctor, and the interactive mode print the npm command that installs the release. The watcher keeps archiving meanwhile. A release not yet published for this platform, such as a Windows preview that lags behind macOS, a prerelease, and a source checkout show a notice instead. Only copies from this release on take part, so the first sheet can appear when a later release ships. - Personal Sync now uploads Library items at once, in a stream of their own, instead of waiting until every device can read them. A device on 0.7.1 receives that stream and lists its items under Other devices. Devices on 0.5.6 to 0.7.0 refuse that one stream, mark a cloud account as Needs update, and keep receiving everything else, though each receive reports a failure and their remote cleanup report is refused while the stream is listed. From this release, a receiver leaves a stream it cannot read, says how many items from which device need a newer Hansard, and receives them after it updates. Sync formats that change how conversations are stored still turn on only once every device reads them, but they hold no upload: conversations upload in the earlier form until then.
- The person’s name in Settings → General becomes one Personal Sync setting that every device in a profile holds. The first pass after the update offers each device’s current name, and the device that runs it first sets the name the others take, so a device may change to another device’s name. An edit made after that wins on every device, and archive maintenance relabels this device’s archived conversations with a changed name. Device names stay on each device. Earlier copies carry the setting without applying it and keep their own name until they update.
- Release preparation resets the 150 parser entries to the new baseline
0.8.0.0, replacing their0.7.1.*versions, including that of the newchatgpt-messages-historysource. Refresh after updates therefore re-reads every enabled source once, including sources whose importer did not change. Provider files still present are imported again, files older than the import window are read by one low-priority import run, and conversations whose provider files are gone are parsed again from Hansard’s raw copies without keeping fewer messages. The work runs in background batches on AC power while imports are idle. Settings → Imports → Maintenance andhansard statusshow its progress. No complete archive reimport is required. - Importer changes that the refresh brings to earlier history:
- Claude Code and the Claude SDK classify the tools-used session record as hidden instead of counting it as an unknown record, and know ten record and content types that Claude Code 2.1.275 through 2.1.319 write: a refusal without a fallback model and stopped agents keep a context row, and bridge sessions join the Remote Control evidence. Headless Claude SDK subagent runs import as separate conversations linked to their parent’s Agent calls.
- Codex CLI, desktop, and SDK imports keep the files a code-mode patch adds,
and a credential-free part of an MCP result’s structured content that
its text leaves out. They also know the records that Codex through
rust-v0.167.0 writes, so
additional_toolsno longer counts as an unknown record in every session from Codex 0.165.0 on. A Codex attached thread reads as a fork of the thread it came from, image generation draws as a call row and a result row with its image, and the session summary keeps the folders a turn’s sandbox may write. Claude app sessions keep the folders the person added to them. - Antigravity app, CLI, and IDE imports link subagent runs to their spawning
calls with their role and final status, and the Antigravity CLI’s failed
terminal steps no longer count as unknown records. Muse Code imports link
subagent runs and keep provider-started reminder children apart from
delegated runs. Muse Code 1.4.14 journals fold approvals into runtime
approvals, show display prompts, steers, and readable reasoning, and keep
the archived history when Muse prunes a journal at a context checkpoint.
A Muse Code conversation is titled by its first request instead of the
handle Muse gives it, such as
lake-pisces, which stays as an alias. - Grok Build permission, retry, hook, and subagent records, Devin CLI compaction and context-only records, and Kimi CLI approval, hook, retry, status, and compaction records gain a line of content and a context kind, so they no longer appear as blank System rows. Grok Build’s automatic compactions read as started, finished with token counts, failed, or cancelled, and a failed MCP server reads as an MCP row.
- pi and iFlow compactions, Crush finish parts, and Qwen Code tool telemetry become runtime evidence, with context sizes, durations, statuses, and error classes. Crush 0.100.0 subagent reports become task notification rows that keep their output, and the host context and notes it sends ahead of a prompt read as a prompt context row. Factory Droid 0.23x compaction notices count the skills and images carried over, and Prime 0.9.5 and 0.9.6 compaction rows keep their harness state digest.
- Sessions that failed to import now import: Mistral Vibe 3 Unified stores at store format minors 9 and 10, MiMo Code 0.1.16, and pi 1.5.0 sessions whose usage records a provider-reported total. A moved Mistral Vibe session keeps its new working directory.
- Text that was not the person’s no longer reads as theirs: Qwen Code
0.26.2’s memory catalog snapshot is hidden, and Cline SDK messages that
its runtime wrote become system reminder, compaction, and provider error
rows. MiniMax Code 0.7 system errors become provider error rows instead of
model text, and its
run_codechild calls link to their parent. Cline SDK tool activity that the provider ran reads as call and result rows, generated media as attachments, and a forked session as a branch of its source. MiniMax Code sessions read from the pi history gain therun_codechild calls their display rows name, with each saved image on its tool result. Qwen Code 0.27.0’s title sidecar names a session whose transcript lost its custom title or first prompt. - A GitHub Copilot CLI 1.0.106 session whose
events.jsonlrolled over imports every segment instead of only the newest, and a gptme 0.35.0 conversation first imported after a manual compaction keeps its earlier history fromlossless.jsonl. - New Warp conversations keep their billed cost after Warp 0.2026.10.14
retired its earlier cost field, and the fields Warp 0.2026.10.07 through
0.2026.10.21 add, such as web fetch charges and a command that did not
start, no longer count as unknown. Advisor calls that Auggie 0.37.0
writes draw as Augment tool calls. Kimi Code 2.3.0 through 2.5.0, DeepSeek
Harness dsh-v0.2.1, Prime v0.10.1, and Devin Desktop records no longer
count as unknown. Kimi Code 2.5’s workspace catalog supplies a working
directory, and the Devin CLI’s sessions are read from
DEVIN_SESSIONS_DIRwhen it is set, which CLI 3000.11.92 supports. - Claude.ai browser captures and exports keep a long history of inputs in
pages, and capture continues from a verified checkpoint. Raw rebuild
reads the original inputs page by page. Failed captures resume through
their retries or
hansard browser retry. Histories already marked as unavailable for raw replay keep that status and their archived content. Devin browser captures keep messages that hold only an attachment. - Instinct, Poke, and ChatGPT texts fold each Messages reaction, tapback, and sticker onto the message it names, record the message a thread reply answers, and read a vCard attachment as a contact card. The refresh counts a folded reaction as a kept row, so these conversations are parsed again even though they list fewer rows.
- If the watcher or Refresh after updates is off, run
hansard rebuild --stale-parsersto re-read available native history with current importers. Usehansard rebuild --from-raw --since allfor supported preserved captures and for the Devin CLI, OpenCode, and MiMo Code SQLite snapshots, which automatic raw replay skips. - The inferred title version moves from 14 to 16. A conversation whose title
came from a delivered Hansard agent message is titled again from its
transcript. A request that only points elsewhere, such as one to read the
message above or to treat it as the goal, is titled by the words it
names, else by the next request, and a provider title that is only such a
pointer titles nothing. Refresh after updates retitles stored
conversations in the background. With it off, run
hansard rebuild --since all. Derived file and search index versions are otherwise unchanged. - Cached conversation lists refresh on their own for the new
Not in a project folder names and for ChatGPT texts, which now list
under their ChatGPT dot room. Persisted Stats refresh on their own for the
new model prices and fast-tier pricing. The experience index’s rule
version moves to 3, which records the memories a conversation read: the
watcher’s pass derives conversations from the last 30 days again, and
hansard experience rebuildcovers older ones. - Playbook tools are now on by default. New local agent sessions list
save_playbook,propose_playbook, andlearn, which add about 2,000 tokens of tool definitions. A configuration written before this default records no choice and takes it. An agent asked for a playbook saves it in the same conversation, and an agent may offer one playbook on its own after substantial work, which waits for approval. Turn off Let agents save playbooks in Library → Playbooks or Settings → Coding agents, or runhansard mcp tools disable playbooks. Hosted assistants and sessions using--no-memoriesdo not list these tools. - Approvals that the plugin bridge remembered before this release expire once, so each bridged tool that asks prompts again. The bridge now reads a tool’s own MCP annotations to decide whether it only reads, and a tool group’s mode can differ for each agent. Computer control in Settings → Coding agents starts on for every agent. Turned off for an agent, it withholds every tool that controls the computer from that agent.
- API key accounts now spend only after explicit consent. Keys saved before
this release stay off and serve no routed request until spending is
allowed. Turn on Allow API key spending on the key’s page in Accounts,
or run
hansard account api-key save --id <account-id> --allow-spend true. Replacing a key turns spending off until it is allowed again. The key’s page replaces the former Manage dialog, and turning off Allow API key spending replaces Pause account. Caps and project rules still apply. Update every routing device before adding an OpenRouter, Bedrock, or Vertex AI key: earlier copies carry its synced record without applying it. No reimport is required. - The managed router now pins CLIProxyAPI 8.0.63, which fixes the two
denial-of-service paths present in 7.3.20 and adds Codex refresh recovery,
Claude Fable 429 classification, and Muse Code header fixes. An app update
or restart keeps the installed router binary, whether 7.3.20 or 8.0.47.
Run
hansard account proxy install --allow-major-upgradeto install the pinned release. The flag is needed only when moving from version 7. A running router keeps serving until it has been quiet for 65 minutes, and then its worker starts the installed release. For an immediate upgrade, runhansard account proxy stop, the install, and thenhansard account proxy start, which ends a router the stop left answering, where earlier builds asked for a computer restart. Stopping interrupts active requests, which need a retry. The upgrade preserves keys and saved sign-ins. Version 8.0.63 keeps Codex refresh claims and their receipts in.codex-refresh/under the router’s auth directory: backups and restores must keep that folder with the credentials, and a router that reports an uncertain refresh needs a new sign-in or the credentials of the copy that refreshed successfully. - Running roster agents that stop on a usage or rate limit now continue once
their account can serve them again. An agent pinned to a router account
waits for that account’s own reset plus two to five minutes and is never
moved. Receipts and the roster say when each one continues.
hansard config set orchestrate.reviveAfterLimit falseturns this off. Revival does not reopen agents that a computer restart stopped. - Claude Code and Codex agents that
start_agentsstarted now pause once they finish their turn and sit idle, like other conversations, unless the person typed in them. A session can start any number of helpers, andorchestrate.delegation.maxChildrenPerParentis retired: it is ignored on load andhansard config setrefuses it. A project’s Helper budget counts only helpers that are waiting to start or running. - In Agent messaging → All projects, agents can now message sessions in other projects on their own, not only find them, when the device knows the sender’s project. Same project keeps their messages in their project unless the person asks them to contact another one.
- On macOS, a new Hansard home stores its contents in a sibling
.noindexfolder,~/.hansard.noindexby default, with~/.hansardkept as a compatibility link, so Spotlight leaves archive contents out of its index. Existing homes stay where they are unless migration is chosen in Settings → Imports → Maintenance or withhansard config set archive.spotlightExclusion migrate. The installed app’s watcher then moves the home once it can pause archive services safely. Filesystem backups must include the physical folder, not only its link.hansard doctorreports the layout. Windows and Linux keep their layout. No rebuild or reimport is needed. - Restart agent sessions to load
research_past_sessions, the context source tools, and the playbook tools. Where Hansard’s managed local MCP server is installed, integration sync turns off Hansard’s discovered ChatGPT app in local Codex and its claude.ai connector in Claude Code, and removing the integration restores switches that still hold Hansard’s values. Unlessintegrations.autoInstallisfalse, the integration pass installs Hansard’s integration for supported agents it detects for the first time, which now include Goose, Qwen Code, and Crush. It refreshes skills and commands whose installed copy is still exactly what Hansard wrote, and keeps copies the person edited. A Mistral Vibe install that had only the turn-end hook gains the MCP entry, skills, and tool hook on the next sync. The sync also writes Hansard’s MCP entry for the Cline CLI into~/.cline/data/settings/cline_mcp_settings.jsonand for Kimi Code into~/.kimi-code/mcp.json, the files each one reads, instead of files they do not read. - A notification for a subscription plan change starts on, under its own
switch in Settings → Notifications. A Personal Sync backup that goes
over its storage budget, or would pass it within 30 days at its last
month’s growth, raises one notification under Import or sync needs you.
Hansard deletes nothing to meet a budget. While a device follows the remote
host, the Mac stays awake on AC power. Turn off Keep this Mac awake in
Settings → Remote access → Advanced, or run
hansard config set remoteAccess.keepAwake false. - The Library reads archived conversations again once, in resumable watcher
passes, for its new collection rules, and gives stored items whose files
can still be read a version that holds them. It now also keeps some found
items on its own: pages and components, files an agent ran or read again
after writing them, files a later conversation used, and files that a
conversation’s last reply names. Each such item says
Kept automatically, and Personal Sync uploads it with the other kept
items. Return to Found in the item’s More actions, or
hansard library unkeep <id>, undoes this, and the rules never keep that item again. A file that the scratch source and a conversation’s write both collected becomes one item once. This needs no rebuild. - Team uploads and receives now leave out every Library file. Earlier releases uploaded kept Library items’ records and files to the storage of a Team with no match rule, where teammates’ Hansard stored them without listing them. Copies already uploaded stay in that storage.
- Extension
0.8.0.0retries each conversation on its own schedule, so another account’s conversations, unfinished replies, and failing conversations no longer hold up the rest. A ChatGPT or Claude conversation that fails, times out, or is refused fails alone and is set aside after three tries instead of pausing the provider, and large conversations get 90 seconds to load. It follows newer Gemini, Z.ai, Devin, Kimi, and NotebookLM pages, lists Devin sessions with their attachments and recordings, captures a ChatGPT dot’s visible tasks and threads into its room, and reports its browser, health, and scan counts to Hansard. A page observer that an extension reload left in an open tab stops instead of throwing on each change. After it updates, Rescan all history fetches the Devin attachments and recordings that earlier captures left out. It needs no new permission and ships separately from npm and desktop updates, with its own store review. With an earlier extension, Settings explains a quiet archive from Hansard’s side alone. - The Windows x64 preview moves from 0.7.1 and stays unsigned. Download the installer with Settings → About → Check now or from hansard.dev, quit Hansard, and run it. The installer registers login startup for an archive that is already set up.
0.7.1
- Update every Hansard copy that shares an archive, including the desktop app and npm installation, and update each Personal Sync device. Indexed view pages, subject assignments, storage-copy receipts, and helpers with inherited permissions have newer reader requirements. Saved-login records now require account reader version 6, and launch preferences require routing reader version 2, so earlier copies cannot rewrite Muse Code account choices. API accounts awaiting local keys or folder mappings require reader version 3. The derived memory catalog requires reader version 3. New playbook proposals require record reader version 2, preventing earlier copies from approving them as instruction lines. New classification records use schema version 4 and schema registry version 2. Earlier copies preserve these newer records instead of overwriting them. Library and experience stores use writer version 4 with reader floor 1, preserving earlier reads while blocking older writes. Library sharing and sharded Personal Sync inventories wait until every participating reader supports them. These changes need no complete archive reimport.
- Refresh after updates now includes enabled sources whose older
conversations fall outside the normal import window. The watcher queues
one low-priority import run for those sources, replays supported manual
exports from preserved raw copies, and retries imports left failed by
earlier releases. Background refresh runs on AC power while imports are
idle. Settings → Imports → Maintenance and
hansard statusshow its progress. Release preparation resets the 147 existing parser entries to baseline0.7.1.0, replacing their0.7.0.*versions. The new Dot task source,codex-dot-task-browser, uses0.7.1.1. The first refresh can therefore re-read sources without a behavior change listed below. The suffix reset does not reverse earlier importer fixes or require a complete archive reimport. - If the watcher or Refresh after updates is off, run
hansard rebuild --since allto refresh derived files. Runhansard rebuild --stale-parsersto re-read available native history with current importers. Usehansard rebuild --from-raw --since allfor supported preserved captures and SQLite source cohorts, including Devin CLI, OpenCode, and MiMo Code, which automatic raw replay skips. A derived rebuild alone cannot recover fields an earlier importer omitted. Unsupported export replay, missing raw evidence, and a replay that would lose messages remain unchanged. Reimport the original export when its replay is unsupported. Rebuild everything, also available ashansard rebuild --everything, requests a full background refresh and is not required for an ordinary update. - Conversation-name changes re-read Claude Code, its SDK and desktop/cloud surfaces, Codex CLI and SDK, Cursor CLI, Copilot, Factory Droid, Grok Build, Qwen Code, Kimi Code, Mistral Vibe, CodeBuddy, MiMo Code, and the other importers that retain explicit names. They also cover Augment, Devin CLI, OpenCode, Kilo Code, Crush, Cline CLI, Continue, Posit Assistant, gptme, OpenHands, DeepSeek Harness, Windsurf, pi, Prime Agent, Goose, Zed, Hermes, OpenClaw, Junie, Qoder, Warp child agents, and Roomote. Perplexity and DeepSeek browser captures retain recorded renames. Codex app adaptive titles remain provider titles. Names set in Hansard continue to outrank all of them.
- Claude Code, Codex, Cursor, Copilot cloud, Factory, Grok Build, iFlow, Qoder, and Antigravity imports distinguish more harness records from human messages. Stats can therefore report fewer human turns after refresh. Antigravity also counts retries only after the first attempt, records file writes as edits, and retains screenshots and recordings from brain folders. Claude Code imports store changed subagent runs separately from their parent. The watcher re-reads these sources automatically. The manual native and raw commands above provide the same importer updates where their evidence exists.
- NotebookLM browser imports retain open Studio notes, and experimental Gemini
browser imports retain Canvas documents present in captured history.
Existing supported captures can be replayed with
hansard rebuild --from-raw --source-type notebooklm-browser --since allandhansard rebuild --from-raw --source-type gemini-web-browser --since all. Earlier captures without those bytes need a new capture. The browser extension ships separately, and a source collector is not a claim of Chrome Web Store availability. Gemini Canvas live capture remains experimental. Experimental Dot imports also retain task references, including reported parents and visibility. Refresh retained references withhansard rebuild --from-raw --source-type chatgpt-dots-browser --since all. A reference does not contain a delegated task’s transcript. This refresh does not fetch missing tasks or infer absent visibility. - View-page manifests move to version 4. The refresh converts compatible page
manifests, builds conversation outlines, and converts existing Claude Code
subagent summaries from archived evidence.
hansard rebuild --since allperforms these steps without reading provider stores. Search moves from index version 22 to 26 through schema changes and a copy of stored search rows. Its document signatures and embeddings remain valid. Stats, Graph, subject assignments, and Library indexes refresh their derived data without a complete reimport or manual index deletion. The memory catalog rebuilds its derived counts automatically. Playbook store updates need no reimport. - Resume command placement now accompanies automatic pause unless
agents.resumeCommandHookwas explicitly disabled. Hansard places the command in supported cmux or tmux terminals, or installs a shell hook in~/.zshrcor~/.bashrc. The separate setup and Settings switch is gone.hansard config set agents.resumeCommandHook falsedisables placement and removes the hook. Pause idle agents remains available. - Notifications now have their own Settings → Notifications page.
Approvals, questions, failed runs, lost Claude or ChatGPT sign-ins, and
import or sync problems notify by default. Finished runs, coordinator
follow-ups, and available updates start off. Destinations include macOS,
cmux, and a paired phone, with Focus, quiet hours, and burst controls.
hansard notify statusshows the choices.hansard config set notifications.enabled falseturns them off. Slack keeps its separate configuration. - Saved logins belonging to different accounts no longer share a sign-in
folder. The next usage check repairs shared folders, preserves earlier
settings and history, and names any account that needs a new sign-in.
Check Accounts → Connections or
hansard account statusafter updating. Signing in again also restores a paused router copy when its account matches. - Personal Sync → Cloud accounts chooses one device to capture each
shared cloud account. Other devices receive that history through Personal
Sync.
hansard personal-sync cloud-accountsshows the selected device, andhansard personal-sync cloud-accounts owner <account-id> --device <device-id|this>changes it. The former Instinct-only settings become Messages assistants, with separate Instinct and Poke number fields. Existing Instinct settings remain. Both fields now validate complete phone numbers. Invalid saved numbers need correction before capture resumes. CLI configuration still requires a leading+and country code. - Privacy & Sharing → Hide secrets now shows redaction rules directly.
Enabled redaction also masks high-entropy Bearer credentials. Run
hansard redact reapplyto apply current rules to earlier local conversations whose originals the reveal cache can reconstruct. This does not redact preserved provider files or remove copies already shared elsewhere. - Restart agent sessions to load refreshed integrations and the Library and
remote-device tools.
hansard account login,hansard personal-sync auth, andhansard browser pairnow require a person’s interactive terminal, outside an agent session. The watcher and remote host can move to a newer installed Hansard build automatically, and service recovery respects a recorded stop and pauses during desktop installation. - Personal Sync now carries API account metadata. A received account needs Accounts → Add key on this device before it can route requests. Folder-restricted accounts also need local folder mappings. Keys, folder paths, spend totals, and pending spend reservations remain local. A synced cap limits each device’s observed spend, not combined spending across devices. These account changes need no archive rebuild or reimport.
- Extension
0.7.1.1adds optional access tohttps://codex-cloud-backend.chatgpt.com/*for experimental Dot task transcripts. It ships separately from npm and desktop updates. After installing that extension release, enable its ChatGPT switch, grant the additional host, and use Rescan all history. Tasks arrive as separate Codex cloud sessions with their recorded parents and Dot room roots. Replaying old room references cannot fetch those transcripts. Store review and publication remain separate, and live-provider verification of Dot task capture remains pending. - Settings → Classification → Work taxonomy now defaults to ONET 31.0
for new work labels. ONET 30.2 remains available with
hansard classify taxonomy select onet-30.2. Existing labels keep their recorded taxonomy and remain current. Selecting a taxonomy starts no backfill and does not enable classification. Stats groups work labels by taxonomy and release and refreshes its derived data without a reimport. Optional relabeling useshansard classify taxonomy backfill --since 30d --limit 200after work performed labels are enabled. It uses the configured backend, requires a finite window, and allows at most 1,000 jobs with one worker. The task run also refreshes horizon and difficulty labels and respects retry and usage limits. A derived rebuild alone does not relabel work. - Playbook write tools start off.
hansard mcp tools enable playbooksenablessave_playbookandpropose_playbookfor new local agent sessions. Existing playbooks remain searchable and readable while writes are off. Hosted assistants and sessions using--no-memoriesdo not expose either write tool. - The Windows x64 preview moves from 0.7.0 and stays unsigned. Download the installer with Settings → About → Check now or from hansard.dev, quit Hansard, and run it.
0.7.0
- This release is published for the macOS desktop app on Apple silicon, the
Windows x64 preview, and the npm package. Mac apps from 0.6.1 through 0.6.5
update in place with Update and restart, and npm installations upgrade
with
npm install -g hansard@latest. npm 0.6.3, 0.6.4, and 0.6.5 were not published, so npm installations move from 0.6.2 to this release, and the 0.6.5, 0.6.4, and 0.6.3 notes below apply to them as well. - The Windows preview moves from 0.6.4 and stays unsigned. Download the installer with Settings → About → Check now or from hansard.dev, quit Hansard, and run it. No Windows installer was published for 0.6.5, so the 0.6.5 notes below apply to a Windows installation as well.
- The npm package now needs Node.js 22.12 or later, or 20.19 or later on
Node.js 20, the first releases that load ES modules with
require(). Node.js 21 is not supported. On an older Node.js,hansardstops with a message that names the installed version. The desktop app carries its own Node.js. - First update every copy of Hansard installed on a computer: the desktop app and an npm installation alike. As in 0.6.5, archive format 2 conversions, raw compaction, and the Personal Sync formats that need newer readers wait while an earlier copy is installed or running.
- After an update, the watcher now brings archived conversations to the files
the new release writes. In background batches on AC power, while no import
runs, it does the work of
hansard rebuild --since all, converts conversations to archive format 2 and compacts raw source copies once every installed copy and Personal Sync device reads them, and parses a conversation whose provider file is gone again from Hansard’s own raw copy, never keeping fewer messages. This covers thehansard rebuild --since allandhansard rebuild --compact-rawsteps of the 0.6.5 notes and brings this release’s runtime summaries, cache rewrite causes, task lists, and titles to existing conversations without a reimport.hansard statusshows its progress as Archive refresh. Once a compacted conversation uploads, its Personal Sync backup requires 0.6.0 or later on every device for good. - Turn the refresh off with Refresh after updates in
Settings → Imports → Maintenance or
hansard config set archive.autoRefresh false, and then runhansard rebuild --since allonce. An npm installation that does not run the watcher runs that command too. - The search index derives every conversation’s documents again, and search by meaning embeds every conversation again, since both now carry this release’s event and index versions. Both run in the background and can take hours on a large archive, and search keeps answering meanwhile. Search by meaning pauses on battery power, and the watcher installs its new llama.cpp runtime, about 12 MB on macOS and up to 20 MB on Windows and Linux, on its next pass and keeps the downloaded models.
- Most importers changed. Claude Code, the Claude SDK, Codex, Cursor, Devin,
Grok Build, Antigravity, Kimi, MiMo Code, OpenCode, Aider, and many others
now keep runtime evidence (approvals, waits for the person, failures,
retries, compactions, credits, and context usage) and the records they do
not recognize. The Codex importer reads a rollout that Codex compressed as
.jsonl.zstwith its title and subagent links, so a conversation an earlier release archived from one imports again once. The Claude Code importer reads names set with/renameorclaude -n. The watcher reads the conversations in its import window (30 days by default) again with the new importers, and the archive refresh parses again those whose provider files are gone. - Refresh older history with
hansard import --sources claude,claude-sdk,codex-cli,codex-desktop,codex-sdk --since all, adding other sources as needed. Each release starts a new parser baseline, sohansard rebuild --stale-parsersand Re-read with current importers would re-read every local source; prefer that command. Devin CLI, OpenCode, and MiMo Code histories kept as SQLite snapshots stay out of the automatic refresh, andhansard rebuild --from-rawrebuilds them. - The Codex cloud and Perplexity Computer browser importers changed. The
archive refresh parses earlier captures again from Hansard’s raw copies, so
Codex cloud tasks take their pull requests’ repository and Perplexity
Computer replies show. With the refresh off, run
hansard rebuild --from-raw --source-type codex-cloud-browser --since alland the same command with--source-type perplexity-computer-browser. - Two behaviors start on by default. Hansard pauses an agent that waits at its
prompt in a terminal 65 minutes after its last model request, once its
prompt cache is cold, and after 15 idle minutes under critical macOS memory
pressure. The conversation stays saved, and Resume in Running brings it
back where it ran. Turn off Pause idle agents in
Settings → Handoff & helpers → Pause and Resume or run
hansard config set agents.autoPause false. Resuming or messaging a Claude Code or Codex conversation in the viewer also stops its copy running in another terminal app first: a copy at its prompt stops at once, and the viewer asks before stopping one that works.hansard config set orchestrate.takeOverElsewhere falsekeeps both running. - Conversation labeling and automatic labeling are now off unless turned on,
so an installation whose configuration never set them stops labeling new
conversations. Turn them on in Settings → Classification or with
hansard classify enableandhansard classify auto enable. Labeling requests now leave out common secret patterns even when archive redaction is off. - The watcher and the shared MCP host move to the new code on their own.
Restart agent sessions to load the
ask_user,peer_file,code_history, andwork_contexttools. Every tool call now answers within 120 seconds, or within the longest waitask_session,ask_user, andwait_agentsallow plus 30 seconds, and ends with atool_timeouterror past it. - Commands that act for the person now refuse to run inside an agent session,
and most of them also need an interactive terminal. They include
hansard coordinator startandsend,hansard peers answer,hansard team accept,hansard remote host pair,hansard personal-sync devices --confirm,hansard device pair, and the review commands ofhansard memory dream.hansard coordinator startreads a brief only from--briefor--brief-file, andhansard coordinator sendits words only from--textor--text-file. In the desktop app, answers, approvals, and grants need the app’s own window, and a browser tab needs the code thathansard webprints. - Routing now keeps each conversation on the account that first served it in
every mode, and moves it once when that account reaches a limit or fails.
Run
hansard account proxy client configure claudeagain and restart Claude Code to give a routed setup from an earlier release the one-hour prompt cache for main conversations. - Update every member of a Team. Team people records now carry revisions and removed device keys, which members on 0.6.5 and earlier cannot read, so those members keep the details they last verified. A manager can turn on Compress shared files on a Team’s Rules page, which cannot be turned off later; a member on an earlier release then refuses the Team’s rules and stops syncing it until it updates, so turn it on once the Rules row counts every device as ready.
- To let the Slack bot take direct messages, update the Slack app from the
manifest that
hansard notify slack bot manifest --direct-messages onprints and reinstall it, since an app installed before has no direct message scopes.
- This release is published for the macOS desktop app on Apple silicon, the
Windows x64 preview, and the npm package. Mac apps from 0.6.1 through 0.6.5
update in place with Update and restart, and npm installations upgrade
with
0.6.5
- This release is published for the macOS desktop app on Apple silicon. Mac apps from 0.6.1 through 0.6.4 update in place with Update and restart. The npm package and the Windows x64 preview skip this release and move to 0.7.0, whose notes list the earlier notes that apply to them.
- First update every copy of Hansard installed on a computer: the desktop app
and an npm installation alike. Archive format 2 now keeps each local
conversation’s Markdown gzip-compressed, which copies from 0.6.4 and earlier
cannot read, so while such a copy is installed or running, imports keep
writing archive format 1 for every file, as they do for copies that cannot
read format 2.
hansard config set archive.format 2names the copies that hold it back. Personal Sync’s release of delivered upload payloads and its deferred Markdown captures also wait until every installed copy supports them, and an earlier copy lists a large first receive that this release started without its conversations until the receive completes. - The watcher and the shared MCP host move to the new code on their own.
Restart agent sessions to load the coordinator tools (
start_agents,deliver_message,roster, andledger) and the shorter descriptions and replies of the recall, messaging, and board tools. - Then run
hansard rebuild --since allonce. It stores the Markdown of every local conversation as*.conversation.md.gz, at about 35 to 40 percent of its plain size; without it, conversations are compressed as they are next written or read. No reimport is required. Commands that name the file (hansard show --path,--open, and--json,hansard history, andhansard status) name a plain copy under~/.hansard/cache/conversation-markdown/, which cache cleanup removes after 30 days unused, so a script that readsconversation.mdfrom the archive directly should take its path from those commands. Exports, Team uploads, and Personal Sync uploads still carry plainconversation.mdfiles. - View pages, which archive format 2 keeps for long conversations, are now stored at gzip level 6 and stay readable by earlier releases. Pages written before are rewritten when their conversation’s view is next written.
- Compress the raw source copies already in the archive with the explicit
hansard rebuild --compact-rawpass, which never runs on its own. Preview it withhansard rebuild --compact-raw --dry-run --json, which lists the eligible files and their sizes without estimating the savings, then runhansard rebuild --compact-raw. It stores each eligible file losslessly in verified 1 MiB chunks without reparsing, needs free space for both forms while it converts, and leaves the replaced objects until archive maintenance collects them after their grace period. It waits while a copy of Hansard or a Personal Sync device cannot read chunked raw storage, and once a compacted conversation uploads, the backup requiresraw-chunk-storage-v1, which version 0.6.0 and later read, on every device for good. Later imports keep the storage modearchive.rawStoragesets. - The Claude Code and Claude SDK importers changed: workflow subagent
transcripts join their parent conversation as subagent runs, and a response
whose rows repeat a partial output count counts its final usage. The
watcher reads the conversations in its import window (30 days by default)
again with the new importers, and the first import of each active
conversation parses it in full once to write the new compressed parser
checkpoint. Refresh older history with
hansard import --sources claude,claude-sdk --since all. Each release starts a new parser baseline, sohansard rebuild --stale-parsersand Re-read with current importers would re-read every local source; prefer that command. Saved Stats payloads are computed again on their own. - Conversations received through a Team now stay out of Sessions, Stats, and
the graph. Turn on Show team conversations in Sessions, Stats, and Graph
in Settings → General, or run
hansard config set privacy.teamConversations shown, to keep them there. - Update every member of a Team. A member on this release lists the change marks other members’ uploads leave and receives as soon as one moves; uploads from a member on 0.6.4 or earlier leave no mark, so they arrive at the Team’s receive interval. Team uploads now leave out conversation views, which every receiver derives from the transcript.
- Personal Sync adds the Compressed file pieces format. Once every
confirmed device reads it, each piece of a file of 1 MiB or more, and a
text file of 64 KiB or more, uploads deflate-compressed when that saves
bytes. Update every device;
hansard personal-sync deviceslists which ones read it. Until then files upload as they are and nothing waits. - Personal Sync now releases the local copy of an upload payload once every
configured destination holds its exact files, after a 15-minute grace, and
leaves a conversation’s Markdown out of a capture until a destination needs
it. Archive maintenance does both; preview the cleanup with
hansard prune sync-outbox --dry-runand apply it at once withhansard prune sync-outbox --yes. After either has run, a copy from 0.6.4 or earlier on that computer cannot open the upload queue, so its Personal Sync captures and uploads stop until it updates. - Remote cleanup stays report-only by default. Its report no longer fails when
rebuilding this computer’s release log would bring the outbox database
within a fifth of its 512 MiB limit; it replays the backup’s history
instead. Preview removals with
hansard personal-sync prune-remoteand apply them with--yes. - On macOS, the updated app moves the watcher’s login startup from its launch agent to the Hansard app’s own login item on its own, so System Settings → General → Login Items lists it as Hansard, and macOS may show a notice that Hansard added a background item. The watcher and its workers then read Documents, Desktop, Downloads, cloud storage folders, other apps’ data, and external and network drives only where macOS allows the Hansard app, so macOS never asks for them in the background. History in a folder the app may not read waits until the Hansard app is allowed under System Settings → Privacy & Security.
- Plugin bridge tools set to ask before each call ask once more, since approvals recorded under the earlier risk rule expire.
0.6.4
- This release is published for the macOS desktop app on Apple silicon, the
Windows x64 preview, and the npm package. Mac apps from 0.6.1 through
0.6.3 update in place with Update and restart, and npm installations
upgrade with
npm install -g hansard@latest. npm 0.6.3 was not published, so npm installations move from 0.6.2 to this release, and the 0.6.3 notes below apply to them as well. - The Windows preview stays unsigned. Download the installer with Settings → About → Check now or from hansard.dev, quit Hansard, and run it. A Windows installation from 0.5.6 skips 0.6.0 through 0.6.3, so their upgrade notes below apply to it as well.
- Update every member of a Team. A member on 0.6.3 or earlier receives only the conversations of members on this release.
- This release is published for the macOS desktop app on Apple silicon, the
Windows x64 preview, and the npm package. Mac apps from 0.6.1 through
0.6.3 update in place with Update and restart, and npm installations
upgrade with
0.6.3
- This release is published for the macOS desktop app on Apple silicon and
the npm package. Mac apps from 0.6.1 and 0.6.2 update in place with
Update and restart. The npm package skipped 0.6.2, so
npm install -g hansard@latestmoves an npm installation from 0.6.1 straight to this release, and the 0.6.2 upgrade notes below apply to it as well. The watcher and the shared MCP host move to the new code on their own, and the managed router after ten minutes without requests. Restart agent sessions to load the recall tools’ new descriptions and thelineoption ofget_memory. - The Windows x64 preview moves from 0.5.6 to this release and stays
unsigned. Download the installer with Settings → About → Check now or
from hansard.dev, quit Hansard, and run it. Then restart an enabled watcher
once with
hansard watcher restart. A Windows installation skips 0.6.0, 0.6.1, and 0.6.2, so their upgrade notes below apply to it as well. - Update every copy of Hansard installed on a computer. A watcher that runs
an earlier copy never rewrites a conversation this release archived or the
search index it built, so new messages in those conversations wait until
this release imports them;
hansard statusandhansard doctorname such a watcher. - No reimport is required. Run
hansard rebuild --since allonce to bring the stored events, tool usage, and outcome totals of earlier conversations to this release: a tool result that names its call now pairs only with that call, and Mistral Vibe Unified Harness edits count as edits in Stats. The watcher reads the conversations in its import window (30 days by default) again with the new importers, and refreshes the search documents of every conversation once because this release derives events differently; search keeps working meanwhile. Saved Stats payloads and the Cursor app generation of recovered conversations are computed again on their own. Each release starts a new parser baseline, sohansard rebuild --stale-parsersand Re-read with current importers would re-read every local source; prefer the commands below. - Importers for Claude Code, the Claude SDK, Claude Science, Codex, Grok
Build, the Gemini CLI, Mistral Vibe, Kimi Code, Roo Code, pi, Qwen Code,
Devin Desktop, Antigravity, Hermes, OpenClaw, MiMo Code, CodeBuddy, iFlow,
GitHub Copilot in VS Code, and Warp changed. Refresh history older than the
import window, including Claude Code fork identities and workflow scripts,
Codex sessions that stopped at an unfinished last record, Antigravity tool
usage, and Claude Science text attachments, with
hansard import --sources claude,claude-sdk,claude-science,codex-cli,codex-desktop,codex-sdk,grok-build,gemini-cli,vibe,kimi-code,roo-code,roo-code-cli,pi,qwen-code,devin-desktop,antigravity-cli,antigravity,antigravity-ide,hermes,openclaw,mimo-code,codebuddy,iflow,copilot-ide,warp --since all. - Refresh cloud histories with
hansard import claude-cloud --since all, which moves Remote Control sessions without a recorded workspace to Claude Code (uncategorized),hansard import claude-cowork-cloud --since all, which adds the files completed Write calls recorded,hansard import cursor-cloud --since all, which reads the run streams Cursor still retains, andhansard import jules --since all. - Browser captures and exports rebuild from the archive’s own raw copies
without a browser:
hansard rebuild --from-raw --provider chatgptrestores ChatGPT project membership and dots reply roles,hansard rebuild --from-raw --provider perplexityre-reads Perplexity captures,hansard rebuild --from-raw --source-type muse-agent-exportkeeps the full tool output of Muse (Personal Agent) side chats, andhansard rebuild --from-raw --source-type claude-web-exportkeeps the Design chats of Claude.ai exports. Choose Rescan all history in the browser extension to download the images of earlier Perplexity captures. - Archive format 2 is now the default, and a configuration in which an
earlier release saved format 1, its default then, reads as format 2. New
imports keep the events of a conversation above 1 MiB as an event record
and the view of a long conversation as compressed pages, and update a
growing transcript in place. Archived conversations keep their files until
hansard rebuild --format 2 --since allconverts them. Imports still write format 1 while a copy of Hansard from 0.6.0 or earlier is installed or running, since those copies read neither form, andhansard config set archive.format 2names the copies that hold it back.hansard config set archive.format 1keeps format 1. Before moving back to 0.6.0 or earlier, runhansard rebuild --format 1 --since allandhansard config set archive.format 1. - Personal Sync adds the Appended file segments format. Once every
confirmed device reads it, a file of 1 MiB or more that only grew uploads
just the bytes appended since its last upload. Update every device;
hansard personal-sync deviceslists which ones read it. Until then such a file uploads its whole last chunk again and nothing waits. - The watcher keeps a cache of what it derived from each conversation active
in the last six hours, up to 1 GiB in all under the Hansard cache folder,
and skips it when the volume would keep less than 2 GiB above the storage
floor.
hansard config set archive.derivationCache falseturns it off. - The managed router’s verified CLIProxyAPI release is now 7.3.20, which
halves the time the router adds before forwarding a 1 MB request. An
installed router keeps its version until Check for update in the
Local router menu in Accounts installs the new one, or until
hansard account proxy stop,hansard account proxy install, andhansard account proxy startdo. - The browser collectors this release adds come from a source build of the extension, which the Chrome Web Store release does not include yet. Update the extension and Hansard together, since this release’s receiver imports their captures.
- A Team that uses a Folder rule or As changes are ready needs every member on this release. Earlier copies refuse that Team’s policy and stop syncing it until they update. A Mac app that installed the first 0.6.3 build keeps it until the next release; download the app again from hansard.dev for these Team options.
- This release is published for the macOS desktop app on Apple silicon and
the npm package. Mac apps from 0.6.1 and 0.6.2 update in place with
Update and restart. The npm package skipped 0.6.2, so
0.6.2
- This release is published for the macOS desktop app on Apple silicon; the
npm package skipped it, and the Windows preview stays on 0.5.6. Mac apps
from 0.6.1 update in place with Update and restart. The watcher
and the shared MCP host move to the new code on their own, and the managed
router after ten minutes without requests. Restart agent sessions to load
the recall tools’ new options, and resume Codex sessions to load
capture_subagent_messages. - No reimport and no
hansard rebuild --since allis required. The Codex, Claude.ai export and browser capture, ChatGPT browser capture, and Muse (Personal Agent) export importers changed. The watcher reads Codex conversations from its import window (30 days by default) again with the new importer; to add MCP tool screenshots to older Codex desktop conversations, runhansard rebuild --from-raw --source-type codex-desktop-history, which replays the archive’s own raw copies. Each release starts a new parser baseline, sohansard rebuild --stale-parsersand Re-read with current importers would re-read every local source; neither is needed. - Graph builds its index again once after the update, and its status line counts the conversations the first pass has read. Navigation and Stats facts, list payloads, and saved Stats payloads are computed again on their own.
- Stats spend estimates change with the refreshed prices. Claude Sonnet 5 is priced at $2 input and $10 output per million tokens throughout, without the September 1, 2026 increase, since Anthropic kept its introductory price as the standard price. The LiteLLM snapshot prices Claude Sonnet 5.5 cache reads at $0.10 per million tokens and adds Claude Haiku 5.5.
- This release is published for the macOS desktop app on Apple silicon; the
npm package skipped it, and the Windows preview stays on 0.5.6. Mac apps
from 0.6.1 update in place with Update and restart. The watcher
and the shared MCP host move to the new code on their own, and the managed
router after ten minutes without requests. Restart agent sessions to load
the recall tools’ new options, and resume Codex sessions to load
0.6.1
- This release is published for the macOS desktop app and the npm package;
the Windows preview stays on its earlier release. Mac apps from 0.6.0
update in place with Update and restart, and
npm install -g hansard@latestupdates an npm installation. Then restart an enabled watcher once withhansard watcher restartor from Importer version in Settings → Imports. From this release on, the watcher restarts itself when the code it loaded changes on disk, when a Node.js upgrade removes the binary it runs from, and once a day, each at a moment when no import, sync, or other pass runs;watcher.restart.onCodeChangeandwatcher.restart.dailyturn either off. The MCP host and the remote host move to new code once no call or run is active, the watcher restarts the managed router on new code after ten minutes without requests, andhansard statusandhansard doctorlist processes that still run earlier code. - Update every copy of Hansard installed on a computer. Until an earlier copy
is updated, Importer version in Settings → Imports moves a watcher
that runs from it, and its login startup, to the app’s copy. While an
earlier copy imports or runs the watcher, it rebuilds the search index in
its own format, and Personal Sync raw object deletes, archive format 2, and
chunked raw storage wait until every installed copy of Hansard supports
them. A copy from 0.6.0 that still runs imports deletes archived duplicates
without this release’s check, so update it or move its watcher to the
app’s copy before running
hansard personal-sync restore-sessions. - No reimport and no
hansard rebuild --since allis required: no importer changed what it archives, and archived events, views, Markdown, tool usage, and titles stay current. Each release starts a new parser baseline, sohansard rebuild --stale-parsersand Re-read with current importers would re-read every local source; neither is needed for this release. Saved Stats payloads are computed again on their own. - The first watcher pass after the update rebuilds the search index once, in
a layout about half its size. The rebuild needs free space above the
storage floor for twice the current index, and at least 512 MiB; search
answers from the previous index until it finishes. Agent sessions and other
processes that started before the update then match exact titles only until
they restart;
hansard watcher restartrestarts the shared MCP host that agent sessions search through. - Personal Sync uploads leave out view files and the events of conversations
with messages, which receiving devices build from the transcript, and each
conversation’s next upload deletes those files from the backup.
hansard personal-sync sweepqueues settled conversations whose backup still lists them, 200 a run. Upload passes also delete raw source objects that no backed-up conversation names. Receivers on 0.6.0 and earlier apply these deletes and keep working, but their knowledge graph loses the links it read from sent events until they update. Each receiving device now re-parses received conversations with its own importer;hansard config set sync.receive.interpret falseturns that off. - Confirm the backup’s devices under Device progress in
Settings → Personal Sync or with
hansard personal-sync devices --confirm. Once every confirmed device reads it, uploads leaveconversation.mdout by default, since receiving devices render it from the transcript;hansard config set sync.sessionPayload fullkeeps uploading it. Without a confirmation, an upload pass confirms the devices on its own 14 days after uploads began waiting on the list, if every device seen in the last 30 days reports the formats it reads. - Personal Sync backs up a running conversation at most every two minutes by
default, instead of every 30 seconds. Back up running conversations
every in Settings → Personal Sync and
hansard personal-sync timing --checkpoint-secondschange the interval, and a device that stored the earlier default moves to the new one. - Personal Sync no longer supports 0.5.5 and earlier, which cannot read what
later releases upload.
hansard personal-sync devices,hansard status,hansard doctor, and Settings → Personal Sync name such a device as unsupported; update it. - Check reclaimable storage with
hansard doctor storage, which names the command for each finding.hansard personal-sync repairtrims received copies and the upload outbox,hansard personal-sync migraterepairs state that earlier versions, departed devices, and interrupted work left behind, andhansard prune reveal-cachereplaces the whole unredacted copies earlier versions kept; the first two preview until given--yes, and the prune previews with--dry-run.hansard personal-sync prune-remoteremoves backup objects that only this computer uploaded; apply it only after every device’s first upload has finished. Upload passes now plan that cleanup at most once a day and report the reclaimable space without removing anything. The next release turns removal on by default;hansard config set sync.remotePrune.enabled falsekeeps it report-only, andtrueturns it on now. hansard doctor storagereports conversations that left the archive, throughhansard deleteor because an import replaced their copy, while the Personal Sync backup still holds them, possibly as their only copy. They leave the backup only oncehansard personal-sync repair --only withdrawals --yesconfirms them, so check the list its preview prints first; a conversationhansard deleteremoves is confirmed at once and leaves the backup a day later.hansard personal-sync restore-sessionslists the conversations the backup holds and the archive no longer does, and with--yesrestores them.- Team uploads remove structural local-path fields and wholly absolute path values from metadata, and transcript metadata and event strings shorten only paths the same record also holds as separate values; a path found only inside a title, summary, or other text can remain, and conversation Markdown clears its working-directory fields but keeps its title and body. The next upload replaces bytes shared earlier when this changes them, and a member on an earlier release keeps sharing paths until it updates. The watcher runs each Team’s passes at its signed policy’s intervals. Team sync removes no files from the Team’s storage.
- Routing and account pools skip a Codex account whose included usage is
used up while it would bill its credits;
hansard account credits <account> onor the account’s Connections dialog allows one. The managed router installs only the CLIProxyAPI release Hansard lists as verified. After a restart, logout, or crash, the watcher starts a remote host again unlesshansard remote host stopor Stop work was the last command. - The watcher writes a live conversation’s
conversation.mdat most every two minutes and again once it settles, and commands that read the file bring it current first; a program that opens it by path reads a complete rendering at most two minutes behind. The reveal cache keeps only the originals of messages redaction changed, and each conversation’s next import replaces the whole copy earlier versions kept, after which an earlier copy of Hansard finds no unredacted text for it. Memory search, the Memories view, and Stats leave out skill folders that earlier backups archived. - The watcher’s integration sync, also run by
hansard integrations sync, gives Codex entries a 31-minute tool timeout forask_sessionandwait_agentsand moves OpenCode’s recall-memories skill into OpenCode’s own skills folder. Restart agent sessions to load the new MCP server instructions. - The browser extension’s next Chrome Web Store release sends nothing to a receiver that cannot prove it holds the browser’s pairing, which this release can, and asks for a Hansard update instead; a browser paired by an earlier release may be asked to pair again.
- The shared MCP host shares each agent’s MCP servers, plugins, and skills
with the other agents by default. Restart agent sessions to see the shared
tools, or set
HANSARD_PLUGIN_BRIDGE=0in the watcher’s environment to turn sharing off.
- This release is published for the macOS desktop app and the npm package;
the Windows preview stays on its earlier release. Mac apps from 0.6.0
update in place with Update and restart, and
0.6.0
- Update the desktop app and every CLI installation on a computer together,
then restart an enabled watcher with
hansard watcher restart. Mac apps from 0.5.6 update in place with Update and restart. 0.6.0 upgrades the local sync outbox the first time it writes, after which a 0.5.6 copy on the same computer cannot write to it. Older copies also no longer rewrite conversations a newer importer archived;hansard statusandhansard doctorreport held conversations and a watcher running a different copy. - Importers for Claude Code, Claude desktop and Cowork, Cursor, Devin
Desktop, Copilot, Factory, Grok Build, OpenCode, MiMo Code, Antigravity,
Goose, pi, Qwen Code, Trae, and Qoder changed. Refresh earlier sessions and
import the new Cursor CLI, Posit Assistant, and gptme sources with
hansard import --sources claude,claude-code-desktop,claude-cowork,cursor-cli,cursor,devin-desktop,copilot-cli,copilot-ide,factory,grok-build,opencode,mimo-code,antigravity-cli,antigravity,antigravity-ide,goose,pi,qwen-code,trae,qoder,posit-assistant,gptme --since all, then recover Cursor models and token counts withhansard import cursor --recover. - Refresh cloud histories with
hansard import claude-cloud --since all,hansard import codex-cloud --since all,hansard import devin-cloud --since all, andhansard import factory-cloud --since all. The Claude and Codex imports move earlier hosted copies under the new Claude Code cloud and Codex cloud providers; Remote Control sessions stay with Claude Code. Import ChatGPT and Claude.ai exports again to add conversation records and alternate branches, and choose Rescan all history in the rebuilt browser extension for ChatGPT, Claude.ai, Perplexity, and Devin captures. - No
hansard rebuild --since allis required: viewer payloads, model and session-kind rules, Stats, and navigation refresh on read or in the background. Each release starts a new parser baseline, sohansard rebuild --stale-parsersand Re-read with current importers re-read every local source; prefer the targeted commands above. - Recall tools now run through one MCP host the watcher starts. Existing
agent sessions keep working and switch when restarted; run
hansard integrations syncso Codex connects to the host, then restart agents. - Direct remote connections now listen on the Tailscale address only.
Restart a running host after upgrading, and run
hansard remote host direct on --network anyon a host that other devices reach over the local network. New grants and pairing codes reach every project unless--projectsor--portfoliolimits them; existing grants keep their project lists.HANSARD_REMOTE_CONTROL=0turns remote control off. - The integration target
cursor-ideis nowcursor, and the earlier names still work. Resume, fork, and copy actions moved into the conversation’s Actions menu, and the remote control dock action into Settings → Remote access. Newly installed harnesses are offered unless turned off throughorchestrate.disabledHandoffProvidersandorchestrate.delegation.disabledProviders. Grok Build and OpenCode run over the Agent Client Protocol;hansard config set orchestrate.acpTransport execrestores the earlier launcher. Writes keep 2 GiB free by default (storage.limits.minFreeBytes).sqlite3andunzipare no longer required. - The Windows desktop app remains an unsigned preview with manual installer
updates. Before moving an older archive to Windows through Personal Sync,
run
hansard update --dry-run --since all, thenhansard update --since all.
- Update the desktop app and every CLI installation on a computer together,
then restart an enabled watcher with
0.5.6
- Quit the desktop app before replacing it with the 0.5.6 installer, then
reopen it. CLI installations should restart an enabled watcher with
hansard watcher restart, then restart the viewer and any agent MCP connections. - 0.5.6 is the first desktop release with in-app updates. Later macOS releases
install from the app with Update and restart; Mac apps from earlier
releases need this one manual upgrade.
hansard app installnow downloads the signed app from hansard.dev and verifies it before installing. - Importers for Codex, Claude Code, Claude SDK, Devin, Grok Build, OpenCode,
and Antigravity changed. Refresh earlier sessions with
hansard import --sources codex-cli,codex-desktop,codex-sdk,claude,claude-sdk,devin-cli,devin-desktop,grok-build,opencode,antigravity-cli,antigravity-ide,antigravity --since all. - Conversations archived before this release gain the revised tool usage
fields, including interruptions and the prompt times Stats places by local
hour, and revised inferred titles after one
hansard rebuild --since all. No reimport is required. - npm installations upgrading from 0.5.4 should also follow the 0.5.5 upgrade notes below.
- Managed agent integrations now include memory search, status reporting,
session identity, peer messages, boards, and helper launches by default.
The watcher applies them on its next integration pass;
hansard integrations syncapplies them immediately. Reload agents afterward.--no-memoriesand explicit off settings are kept. - Codex routing keeps Codex’s own ChatGPT sign-in for plugins and connected
apps. Refresh an existing Codex routing configuration with
hansard account proxy client configure codex, then restart Codex. - Classification labels each conversation with one conversation request and
one task request, so labels from earlier releases are out of date. The
watcher relabels conversations active in the last 30 days;
hansard classify run --profile all --limit allrelabels older ones. - Rebuild and reload the preview browser extension to capture Devin cloud sessions, then choose Rescan all history once to reparse earlier Perplexity captures.
- The Behavior page is now the Changes tab in Stats. Project coordinators
share one harness, model, effort, and helper budget under
Settings → Coordinator. The Chart color setting and
orchestrate.maxActiveRunsare retired; other saved settings are unchanged.
- Quit the desktop app before replacing it with the 0.5.6 installer, then
reopen it. CLI installations should restart an enabled watcher with
0.5.5
- Quit the desktop app before replacing it with the 0.5.5 installer, then
reopen it. CLI installations should restart an enabled watcher with
hansard watcher restart, then restart the viewer and any agent MCP connections so new recall tools, Claude model discovery, and peer delivery load. - Conversations archived before this release gain per-conversation line
counts and the revised tool usage fields after one
hansard rebuild --since all. No reimport is required. - The watcher archives newly supported local agents going forward. Import
their earlier history with
hansard import --sources crush,goose,continue,roo-code,roo-code-cli,kilo-code,kilo-code-legacy,amp,zed,deepseek-harness,hermes,openclaw,openhands,junie,warp,kiro,augment,qoder,trae,minimax-code --since all. Cloud and export sources remain explicit imports; seehansard help import. - Memory backup reconstructs earlier file versions from archived tool
operations. The watcher runs this with its next memory backup;
hansard memory backupruns it immediately. - Settings sections are regrouped under Personal, Archive, Agents, and Sharing, and Harnesses is renamed Coding agents. Saved settings are unchanged.
- Quit the desktop app before replacing it with the 0.5.5 installer, then
reopen it. CLI installations should restart an enabled watcher with
0.5.4
- Quit the desktop app before replacing it with the 0.5.4 installer, then
reopen it. The archive, settings, saved accounts, and credentials remain
outside the app bundle. CLI installations should restart an enabled watcher
with
hansard watcher restartand reopen the viewer after upgrading. - Graph v2 builds its derived index in the background on the first Graph visit. Its new relationships and the expanded account usage fields do not require a provider reimport. The next usage capture fills supported account fields.
- Automatic archiving, plan usage tracking, and secret redaction are selected by default in fresh desktop setup. Existing preferences are preserved.
- The standalone macOS download is available for Apple silicon. Intel packaging and the previously recorded Windows compatibility work remain separate follow-ups.
- Earlier 0.5.4 desktop builds can be replaced with the refreshed installer.
Refresh Claude subagent titles, Grok Build search queries, and Codex browser
request parsing with
hansard import --sources claude,codex-cli,codex-desktop,grok-build --since all.
- Quit the desktop app before replacing it with the 0.5.4 installer, then
reopen it. The archive, settings, saved accounts, and credentials remain
outside the app bundle. CLI installations should restart an enabled watcher
with
0.5.3
-
Claude Code and Claude SDK histories (
cli-history,claude-sdk-history) include corrected timestamp handling. Records without their own clock, such as file history snapshots, no longer take the import time, which had moved the session start after its end. Refresh existing archives with:Terminal window hansard import --sources claude,claude-sdk --since all -
Cline task and SDK histories now use enforced source-audited cohorts. Refresh existing Cline archives and their search entries with:
Terminal window hansard import --sources cline,cline-cli --since allhansard index rebuild -
OpenCode now uses one canonical import selector and physical store owner with four enforced JSON cohorts and five enforced SQLite cohorts. MiMo Code remains an independent enforced SQLite source rather than inheriting an OpenCode storage contract. Refresh both archives and their search entries with:
Terminal window hansard import --source opencode --since allhansard import --source mimo-code --since allhansard index rebuild -
Cursor workspace chats (
cursor-workspace-sqlite) include corrected legacy timestamps. Legacy chat tabs without per-message timestamps are dated from the tab’s recorded send time instead of the workspace store’s modification time, which moved whenever Cursor reopened the workspace. Refresh existing archives with:Terminal window hansard import --source cursor --since all
-
0.5.2
- Version 0.5.2 advances the archive, view, tool-usage, search-index, behavior,
SDK-session, and parser contracts. Existing archives remain readable, but a
complete local refresh is required to backfill the corrected importer metadata
and normalized events. After upgrading, run
hansard doctor, preview withhansard update --dry-run --since all, then runhansard update --yes --since allafter confirming the original provider histories or usable raw backups are available. - Restart a running watcher after a normal package-only upgrade with
hansard watcher restart. The full update command handles watcher restart as part of its maintenance flow.
- Version 0.5.2 advances the archive, view, tool-usage, search-index, behavior,
SDK-session, and parser contracts. Existing archives remain readable, but a
complete local refresh is required to backfill the corrected importer metadata
and normalized events. After upgrading, run