Skip to content

Release Notes

What's changed in each fxv release, newest first.

fxv v0.13.4

Not yet released

  • Changed fxv status to 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 the warnings field of the JSON output. The files in the folder are not listed as changed.
  • Fixed fxv snapshot hanging 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 code 67. 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 copy and fxv doctor reset-sync hanging 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 snapshot exits with it when it skips files it could not read.
  • Changed fxv on Linux and macOS to raise its open file limit when it starts, as far as the hard limit allows. fxv doctor reports the limits. See Raise the open file limit.
  • Changed fxv sync, fxv goto, fxv revert, fxv resolve, fxv branch switch and fxv copy to stop before changing any files when they cannot read a changed file. See Recover an Interrupted Command.
  • Fixed fxv snapshot running 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 open and 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_paths to the interrupted-sync JSON 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 switch and fxv copy reporting 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 code 98. Once the cause is fixed, fxv resume finishes them, or fxv resume --rollback undoes them.
  • Fixed branch-rename missing from the allow list of JSON schemas.
  • Fixed paths in the interrupted-sync JSON 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. Use fxv workspace optimize instead.
  • Added fxv workspace optimize, which optimizes a workspace's draft repository, and with --published or --all, its published repository.
  • Changed fxv repo new to also check that the object store supports a create-only multipart upload and returns Date and Last-Modified headers.
  • 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 doctor exits 4, not 2, when it finds Fail-level checks.
  • Performance improvements: Reduces HTTP roundtrips for remote store, speeds up remote fxv status calls by 2-3x.

fxv v0.12.3

Released 2026-10-21

  • Added fxv user list command, 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 upgrade before this version can use them, and commands exit with code 96 until then. See Upgrade Your Repository.
  • Breaking: Removed the --log-console and --log-console-lines options. Logs are written to the log file only.
  • Breaking: Removed --format json-l.
  • Breaking: Changed the JSON message.kind of fxv doctor reset-sync from goto to doctor-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, and fxv fetch --repair, which first downloads again any file of the local copy that fxv cannot read.
  • Added --skip-remote-update to fxv history, fxv branch list, and fxv branch info.
  • Added JSON output to fxv publish, fxv fetch, and fxv repo optimize, and a warnings field to JSON output for conditions a command continued past.
  • Added progress and a list of published files to fxv publish.
  • Added published_head to the fxv status JSON output for a workspace that has not synced yet.
  • Changed fxv repo new to 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, and fxv branch info to 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, and fxv branch info to 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 optimize failing 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-publish and post-publish) configured via triggers.toml or .fxv/triggers.toml.
  • Added interactive security approval prompts and tamper detection for trigger commands, with approvals saved to trusted_triggers.toml.
  • Added --no-triggers and --trust-triggers flags to fxv publish.
  • Added release channel support (stable and beta) to fxv 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 compatible fxv version range.
  • Added a compatibility guard to fxv upgrade (--check, --to, --allow-incompatible) that blocks upgrades past the range a registered integration supports.
  • Fixed fxv status re-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 sync no longer switches branches.
  • Added explicit branch ancestry tracking (predecessors and merge bases) for more accurate commit provenance.
  • Fixed fxv upgrade platform detection to support Linux.
  • Added a post-install shortcut to open a terminal to fxv and 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 status and 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 resume to continue interrupted sync, goto, revert, and resolve operations without starting over.
  • Added fxv doctor reset-sync to 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 rpc working directory handling by requiring --working-dir at 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 upgrade to 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 revert and fxv resolve to accept paths relative to the current working directory.

fxv v0.5.0

Released 2026-08-12

  • Added fxv cat to 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 doctor check 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 doctor command 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 status JSON output.

fxv v0.2.0

Released 2026-08-06

  • Added fxv changeinfo command 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.