Release Notes¶
What's changed in each fxv release, newest first.
fxv v0.13.4¶
Not yet released
- Changed
fxv statusto warn about unreadable folders/directories (e.g. due to permission issues) instead of failing. The warning includes the folder's path, and is also in thewarningsfield of the JSON output. The files in the folder are not listed as changed. - Fixed
fxv snapshothanging when the workspace has a folder it cannot read. It now commits the files it could read, lists the folder in its warnings, and exits with code67. Changes inside the folder are not recorded until a snapshot can read it. - Fixed
fxv sync,fxv goto,fxv revert,fxv resolve,fxv branch switch,fxv copyandfxv doctor reset-synchanging when the workspace has a folder they cannot read. They now stop before changing any files and list the folder, as they do for a file they cannot read. See Recover an Interrupted Command.
fxv v0.13.3¶
Released 2026-11-12
- Added exit code
67, for a command that succeeded with warnings.fxv snapshotexits with it when it skips files it could not read. - Changed
fxvon Linux and macOS to raise its open file limit when it starts, as far as the hard limit allows.fxv doctorreports the limits. See Raise the open file limit. - Changed
fxv sync,fxv goto,fxv revert,fxv resolve,fxv branch switchandfxv copyto stop before changing any files when they cannot read a changed file. See Recover an Interrupted Command. - Fixed
fxv snapshotrunning out of open files on a large workspace and skipping files, on Linux and macOS. - Fixed running out of open files being reported file by file. The command now stops with
Too many files are openand commits nothing. - Fixed a local change being overwritten when an earlier snapshot could not read the file. The file now stays changed in
fxv status, and the next snapshot reads it again.
fxv v0.13.2¶
Released 2026-11-09
- Added
sampled_failed_pathsto theinterrupted-syncJSON error detail, listing the files a command could not change and why. The detail's version is now 1.1. - Changed a deleted folder that cannot be removed, such as one a terminal has open, to be reported as a warning. The command finishes and leaves the empty folder.
- Fixed
fxv sync,fxv goto,fxv revert,fxv resolve,fxv branch switchandfxv copyreporting success when they could not write or delete some files, such as a file another program had open, or one whose content could not be downloaded. The next snapshot recorded those files as your changes. These commands now stop, list each file with the reason, and exit with code98. Once the cause is fixed,fxv resumefinishes them, orfxv resume --rollbackundoes them. - Fixed
branch-renamemissing from the allow list of JSON schemas. - Fixed paths in the
interrupted-syncJSON error detail using\on Windows. They now use/, as the rest of the JSON output does. - Fixed a file whose folder could not be created being reported as not found.
fxv v0.13.1¶
Released 2026-11-05
- Breaking: Removed
fxv repo optimize. Usefxv workspace optimizeinstead. - Added
fxv workspace optimize, which optimizes a workspace's draft repository, and with--publishedor--all, its published repository. - Changed
fxv repo newto also check that the object store supports a create-only multipart upload and returnsDateandLast-Modifiedheaders. - Changed optimize to refuse to run while another optimize of the same repository is running.
- Fixed optimizing a remote repository, which failed.
- Fixed optimize reporting success when it had failed.
fxv v0.12.4¶
Released 2026-10-28
- Breaking:
fxv doctorexits 4, not 2, when it findsFail-level checks. - Performance improvements: Reduces HTTP roundtrips for remote store, speeds up remote
fxv statuscalls by 2-3x.
fxv v0.12.3¶
Released 2026-10-21
- Added
fxv user listcommand, so you can properly track your users. - Usernames passed to the CLI are no longer case-sensitive.
fxv v0.12.2¶
Released 2026-10-15
- Breaking: Changed the repository format. Repositories and workspaces used with fxv 0.11.0 to 0.11.3 must be upgraded with
fxv repo upgradebefore this version can use them, and commands exit with code 96 until then. See Upgrade Your Repository. - Breaking: Removed the
--log-consoleand--log-console-linesoptions. Logs are written to the log file only. - Breaking: Removed
--format json-l. - Breaking: Changed the JSON
message.kindoffxv doctor reset-syncfromgototodoctor-reset-sync. - Added
fxv repo upgrade, which upgrades a workspace's repositories, or a single repository given by its URI, and finishes an interrupted upgrade when run again. - Added
fxv fetch, which updates a workspace's local copy of its remote repository, for plugins and integrations to keep it up to date, andfxv fetch --repair, which first downloads again any file of the local copy thatfxvcannot read. - Added
--skip-remote-updatetofxv history,fxv branch list, andfxv branch info. - Added JSON output to
fxv publish,fxv fetch, andfxv repo optimize, and awarningsfield to JSON output for conditions a command continued past. - Added progress and a list of published files to
fxv publish. - Added
published_headto thefxv statusJSON output for a workspace that has not synced yet. - Changed
fxv repo newto check that the object store supports the features FlexVault relies on before creating anything, and to report storage errors more clearly. - Changed
fxv status,fxv history,fxv branch list, andfxv branch infoto report from the workspace's local copy, with a warning, when the remote repository cannot be reached. - Changed
fxv status,fxv history,fxv branch list, andfxv branch infoto run while another command is using the workspace, instead of exiting with code 99. - Changed JSON output to write paths with
/separators on every platform. - Fixed workspaces of a remote repository becoming unable to load or publish after an interrupted or concurrent publish left their local copy out of step with the remote.
- Fixed workspaces sharing a repository overwriting each other's changes when they published, or changed branches or users, at the same time. The second change fails instead, and can be retried.
- Fixed an interrupted commit preventing later commits to a workspace or a local filesystem repository.
- Fixed
fxv repo optimizefailing after an interrupted run on a local filesystem repository or a workspace's local data.
Thanks to Christopher, Aiden Collins-Cruickshank, Dominic Evans, Tori Lee, Andrew Dool, and Evan Kau for beta testing FlexVault, identifying several breaking issues and their corresponding workarounds. We couldn't do it without you.
fxv v0.11.3¶
Released 2026-10-08
- Added
fxv copy, a new command for non-destructively copying files and directories from another revision into the workspace. - Added support for reverting whole directories in
fxv revert. - Added client-side triggers for publish lifecycle events (
pre-publishandpost-publish) configured viatriggers.tomlor.fxv/triggers.toml. - Added interactive security approval prompts and tamper detection for trigger commands, with approvals saved to
trusted_triggers.toml. - Added
--no-triggersand--trust-triggersflags tofxv publish. - Added release channel support (
stableandbeta) tofxv upgrade, including--channel,--set-channel, and downgrade protection prompts. - Added copyright notices and links to terms of service, license, and privacy policy in
fxv --help. - Added third-party open-source license documentation bundled with binary release assets.
fxv v0.11.2¶
Released 2026-09-22
- Added CLI error code 97 for a repository that can't be found at the remote, and unified error and remediation reporting across the CLI.
fxv v0.11.1¶
Released 2026-09-22
- Added
fxv integration, a new command family (list,register,unregister) for plugins and other integrations to register their compatiblefxvversion range. - Added a compatibility guard to
fxv upgrade(--check,--to,--allow-incompatible) that blocks upgrades past the range a registered integration supports. - Fixed
fxv statusre-validating the remote repository over HTTP on every invocation. - Added HTTP request latency metrics, with a warning logged (and printed) when p90 latency exceeds a threshold.
fxv v0.11.0¶
Released 2026-09-22
- Breaking: Stabilized the repository file format. Existing repositories require migration.
- Added
fxv branch, a new command family for creating, listing, renaming, retiring, and restoring branches, including per-user branches. - Added branch switching to
fxv goto;fxv syncno longer switches branches. - Added explicit branch ancestry tracking (predecessors and merge bases) for more accurate commit provenance.
- Fixed
fxv upgradeplatform detection to support Linux. - Added a post-install shortcut to open a terminal to
fxvand show the install path in the Windows installer.
fxv v0.10.3¶
Released 2026-09-17
- Signed the Windows binary and installer (
FlexVaultSetup.exe) with Azure Artifact Signing.
fxv v0.10.2¶
Released 2026-09-16
- Added a Linux musl release binary and removed OpenSSL runtime dependencies.
fxv v0.10.1¶
Released 2026-09-14
- Fixed an argument conversion issue during Windows installer compilation in release automation.
fxv v0.10.0¶
Released 2026-09-14
- Added detailed conflict classification in
fxv statusand JSON status payloads (v2), categorizing conflicts as content modifications, deletions, or type changes. - Added conflict detection for conflicting deletions and directory clashes in
fxv status. - Added dynamic versioning and updated links to documentation and community resources in the Windows installer.
fxv v0.9.0¶
Released 2026-09-08
- Added a graphical Windows web installer (
FlexVaultSetup.exe). - Hardened installation scripts with process checks, safe temporary directory handling, and case-insensitive hash verification.
fxv v0.8.0¶
Released 2026-08-28
- Added
fxv resumeto continue interruptedsync,goto,revert, andresolveoperations without starting over. - Added
fxv doctor reset-syncto repair workspaces with corrupted sync journals. - Consolidated shared local filesystem paths across tools into
fxv_api::paths. - Added User-Agent headers to outbound HTTP client requests.
fxv v0.7.0¶
Released 2026-08-24
- Added a BinaryFuse16 filter ahead of the LSM store index to speed up missing-chunk checks during submissions.
- Added machine-wide workspace registration so background tools can discover active workspaces automatically.
- Fixed
fxv rpcworking directory handling by requiring--working-dirat startup rather than accepting paths per request. - Fixed workspace root resolution when parent directory paths contain symlinks.
- Fixed atomic file replacement and backup handling on Linux.
fxv v0.6.0¶
Released 2026-08-13
- Added
fxv upgradeto download and apply CLI updates directly from the official release mirrors. - Added background update notifications to interactive CLI commands when a newer version is available.
- Updated
fxv revertandfxv resolveto accept paths relative to the current working directory.
fxv v0.5.0¶
Released 2026-08-12
- Added
fxv catto display file content at specific published revisions or draft snapshots without altering the workspace. - Added diagnostic tracing during command execution to assist troubleshooting with
fxv doctor bundle. - Added an
fxv doctorcheck to detect and report orphaned pending LSM segments left behind by interrupted publish operations.
fxv v0.4.0¶
Released 2026-08-10
- Added self-contained release binaries for Windows, with an install script at
fxv.dev/install.ps1. - Added the
fxv doctorcommand for workspace diagnostics.
fxv v0.3.1¶
Released 2026-08-07
- Fixed release upload automation for Windows binaries.
fxv v0.3.0¶
Released 2026-08-07
- Added logged-in user information to
fxv statusJSON output.
fxv v0.2.0¶
Released 2026-08-06
- Added
fxv changeinfocommand to display details of published and draft changes. - Added self-contained release binaries for Windows and Linux.
- Added support for local-only draft checkpoints in workspace status reporting.
- Improved HTTP publish reliability, retry strategies, and diagnostic logging.
- Fixed directory matching when evaluating ignore rules.
- Fixed workspace sync handling on branches with no published revisions.