← All releases

v0.4.0

Separate Approver commands and better connection diagnostics

Passlet v0.4.0 separates commands used by agents from commands that manage the Approver on your Mac. It also adds named SSH sockets, Tailscale HTTPS forwarding, clearer approval prompts, and actionable diagnostics.

Changes

  • Use passlet approver for local service commands, GitHub setup/reset, and audit history. Bare command groups show their available commands.
  • Save an agent connection with passlet connect. Use passlet doctor to check it, or passlet approver doctor to check the local service and verify credentials with Touch ID.
  • Configure named SSH sockets to distinguish request sources in approval prompts. Tailscale requests show the device name. These labels are attribution, not client authentication.
  • Enable Tailscale HTTPS forwarding to a dedicated private Unix socket. Passlet verifies existing Serve configuration, creates missing forwarding, and refuses conflicting routes.
  • Request grants separately, then run arbitrary commands with passlet exec --grant FILE -- COMMAND. Process substitution supports one-off requests without a saved grant file.
  • Read audit history in a human-readable format, or export it with --json.
  • Expand command-help, approval, diagnostic, audit, native Swift helper, and NixOS SSH integration coverage.

Upgrading from v0.3.1

  • This release intentionally has no compatibility aliases. Replace passlet serve with passlet approver start, passlet github ... with passlet approver github ..., and passlet audit with passlet approver audit. Use --version for the version and doctor for connection diagnostics. The standalone import command is removed.
  • Replace ~/.config/passlet/serve.json with ~/.config/passlet/approver.toml. Home Manager generates this file from its service options.
  • In Home Manager, replace programs.passlet.service.tailscaleListen with programs.passlet.service.tailscale = true. Remove custom activation hooks that configure the old TCP forwarding. Tailscale 1.104.4 or newer is required for Unix socket forwarding.
  • Existing TCP Serve forwarding on port 17400 conflicts with the new HTTPS-to-socket route. Inspect it and remove only the old Passlet route before starting the new service. Preserve unrelated Serve configuration.
  • Request scope flags now belong to passlet request. Supply the resulting grant to passlet exec --grant ....
  • Nix consumers must use a revision containing the v0.4.0 package metadata, published after the release tag. The release tag itself still contains the previous package definitions.