[1.17.0] - 2026-08-30
Added
- Add --safe flag to set safecontent on demand (#3318)
- Add --stdin, --file, and --exec modes to gopass env
- Add JSON output to audit, list, find, and recipients commands (I-3)
- Add gopass doctor diagnostic command (I-4)
- Add show.fuzzysearch config and --nofuzzysearch flag to control automatic fuzzy lookup in show
- Add show.hidden-keys config option for customizable safecontent redaction (I-5)
- Add stable structured exit codes; --exit-codes flag lists all codes (I-2)
- add configurable show.hidden-keys for safecontent redaction
- changelog: migrate to Keep a Changelog 1.1.0 (#3506) (#3414)
- env: add --stdin, --file, and --exec modes to gopass env
- gpg: support v5/v6 PGP keys with 64-character fingerprints (#3496)
- machine-readable JSON output (I-3)
- pwgen: add memorable generator support (#3494)
- show: add configurable fuzzy-search fallback toggle (#3449)
- structured exit codes (I-2)
- support -c=N to copy specific line to clipboard (#3386)
Changed
- Define pkg/gopass API stability contract: best-effort stable policy with [PKG-BREAK] changelog tag and minimum deprecation window (A-12)
- Fix documentation vs. implementation mismatches in config.md, show.md, find.md, generate.md, secrets.md, and ARCHITECTURE.md
- Fully document wizard template format, attribute types, and file naming convention (I-7)
- Protect autosyncLastRun with a mutex (S-6)
- Replace context-key config system with typed structs (A-2)
- Replace sort.Strings with slices.Sort throughout (S-3)
- Split Action handler into focused handler types (A-1)
- Standardize XKCD password generator flag names to --xkcd-sep, --xkcd-lang etc. (U-4)
- Unified secret name validation rejects path traversal and consecutive slashes (I-1)
- action: split Action god object into focused handler types (A-1)
- age: share identity file parsing (#3559)
- ctxutil: replace context-key config system with typed structs (A-2)
Deprecated
- Surface GOPASS_AUTOSYNC_INTERVAL deprecation as a visible warning (U-7)
Removed
- Remove cryptic -t alias from --force-regen in generate (U-6)
- Remove misleading --force / -f aliases from --unsafe in show and find (U-1)
Fixed
- Add thread safety to SSH identity cache (M-3)
- Avoid NPE when attempting to edit a non-existing secret (#3489)
- CI: moving to go 1.25 (#3322)
- Configure .gitattributes based on the backend (#3427) (#3409)
- Correctly honor show.safecontent overrides in substores (#3337)
- Default audit output to summary when no format flag is given (B-7)
- Disable grype, the builder seems to be broken (#3463)
- Fix autoSync debounce timestamp to update on success instead of failure (B-2)
- Fix convert backend name in error messages (B-5, B-6)
- Fix create wizard maximum-length check (B-3)
- Fix grep match and error counters in audit summary (B-1)
- Fix queue goroutine leak and Add() post-Close() panic (B-8)
- REPL tab-completion for entries with spaces (#3360)
- Support HW Age identities (#3389) (#3387)
- Support strict character class enforcement in create templates (#3352) (#3350)
- Update fish completion to remove warning (#3339)
- add case-insensitive secret name normalization (#3390) (#2837)
- add hidden pull and push commands (#3532)
- address A-5, S-1, S-2, S-3, S-4, S-6 and I-1 from code quality audit
- address CLI/UX issues from code quality audit
- address all confirmed bugs from code quality report
- age-agent: handle AGE-PLUGIN-* identities to fix 'malformed secret key: mixed case' error (#3397)
- age: deterministically order identities for decryption (#3566) (#3393)
- age: expand ~/ in age.ssh-key-path (#3474)
- age: only encrypt for recipients in .age-recipients (#3564) (#3392)
- age: raise agent scanner buffer limit to handle large decrypt payloads (#3529) (#3508)
- age: recover agent on missing identities, not only when locked (#3488)
- age: send agent identities space-separated on a single line (#3509)
- backend: add storage.backend config key to lock backend selection (#3332) (#3398)
- clip flag (-c) for cli/v3 GenericFlag compatibility (#3448)
- config: restore sub-store fallback for core.exportkeys (#3379)
- copy: preserve directory structure when copying with trailing slash (#3396)
- docs: removing reference to invalid 'gopass binary' command, and adding docs for 'fsmove' and 'fscopy' (#3321)
- drain background queue before exiting on failure (#3528)
- eliminate audit, queue, and test initialization races (#3540)
- fix lint issues and update tests for removed show -f/--force alias
- gpg: make identity selection deterministic (#3577)
- highlight linked secrets in ls output (#3536)
- honor core.autopush during root-store move operations (#3535)
- pwgen: remove math/rand fallback (#3531)
- queue: fix Idle() TOCTOU race and Add() post-Close() panic
- recover from panic during shell completion with unknown flags (#3388)
- require --age-sshkeys (or age.sshkeys config) to access ~/.ssh (#3525) (#3522)
- restore clip flag through fuzzy search in show command (#3466)
- secparse: replace panic in MustParse with testing.TB.Fatalf (#3420)
- setup: rename --alias/--create to --team/--create-team (#3568) (#3497)
- setup: suppress auto-commit in gitfs when setup remote is specified (#2901) (#3391)
- store mount paths relative to home dir for cross-platform portability (#3439) (#2897)
- tempfile: mount macOS ramdisk read-write (#3527)
- todos: resolve all stale TODOs from S-5
- update bash completion flag for urfave/cli/v3 compatibility (#3441) (#3440)
- updater: cap archive/icon extraction writes and surface oversize errors (#3530)
- use imperative mood in generated commit messages (#3492) (#1222)
- warn when recipient key is expired or unusable during encryption (#3443) (#2885)
Security
- Bound symlink traversal to store root (H-2)
- Fix path traversal vulnerability in fs storage layer (C-1)
- Restrict template engine secret access and fix error information leakage (H-1)
- Validate editor binary path before invocation (H-3)
- Warn on env command secret exposure via environment variables (C-2)
- bound symlink walk to store root (H-2)
- document and warn on env command secret exposure (C-2)
- fix path traversal in fs storage layer (C-1)
- restrict template engine secret access and fix error leakage (H-1)
- validate editor binary exists before invocation (H-3)