Repository navigation
v0.4.0
·
55 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
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 approverfor local service commands, GitHub setup/reset, and audit history. Bare command groups show their available commands. - Save an agent connection with
passlet connect. Usepasslet doctorto check it, orpasslet approver doctorto 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 servewithpasslet approver start,passlet github ...withpasslet approver github ..., andpasslet auditwithpasslet approver audit. Use--versionfor the version anddoctorfor connection diagnostics. The standaloneimportcommand is removed. - Replace
~/.config/passlet/serve.jsonwith~/.config/passlet/approver.toml. Home Manager generates this file from its service options. - In Home Manager, replace
programs.passlet.service.tailscaleListenwithprograms.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 topasslet 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.