Repository navigation
Releases
v0.12.0
Run GitHub commands with one Passlet call, and reuse approved access across sessions without repeated approval prompts.
- Scoped
passlet exec --repos OWNER/REPO --permissions contents:read -- COMMANDreuses approved access or requests approval when needed. Grants are saved in a private file cache shared by sessions under the same OS user and paired identity. Cached access works while Approver is offline, without extending its scope or expiry. Grants with less than one minute remaining require fresh approval. - After a command fails, Passlet removes a cached token only when GitHub confirms it is rejected. The next ordinary invocation can obtain fresh approval. Failed commands are never replayed automatically.
passlet requestnow prints only a receipt by default. Scripts that consume grant JSON must add--stdout, or keep using--out FILE. Use--no-cachewith either output option for fresh approval without cache lookup or storage.- The agent skill uses the single-command workflow, handles recoverable failures quietly, and reads public repositories anonymously without approval.
v0.11.0
Linux releases now ship Agent only, and Home Manager installs start cleanly on a fresh machine.
- Linux binaries leave out Approver and are half the size, at 7 MB.
passlet approvercommands on Linux report that they require the macOS build. Packagers building Agent from source can use the sameagentonlyGo build tag. - Approver starts and creates its pairing key after a fresh Home Manager install. Each activation also repairs existing state directory permissions while preserving credentials.
- Installing from Nix no longer warns about missing metadata files while unpacking release archives.
Manage coding-agent plugins with Home Manager
Install and update the Claude Code and Codex plugins through Home Manager, alongside your Passlet configuration.
- Install Claude Code and Codex plugins through Home Manager with
programs.passlet.plugins.claude-code.enableandprograms.passlet.plugins.codex.enable. These options require Home Manager 26.05 or newer. Remove manually configured Passlet marketplace and cache entries before enabling them. - Agents can use scoped grants with the GitHub API when
ghis not installed. The bundled skill explains how to usecurlwithout exposing the token. - Test a checkout by stopping the installed service and running the checkout’s
passlet approver startin the foreground. Usepasslet approver restartafterward to restore the installed version.
Passlet now requires macOS 26 or later on Apple Silicon. Intel Macs and older macOS versions are no longer supported. Linux Agents remain available for amd64 and arm64.
Existing credentials and pairings are preserved. The macOS download is now named passlet_0.10.0_macos.zip.
v0.9.0
Organization members can now complete GitHub setup after an owner approves their app installation, without forwarding localhost callback URLs between machines. Enter the organization's GitHub name, share the approval link with its owner, and click Check approval once approved. Keep the browser tab and passlet approver github setup command running until setup completes.
- After setup, drag the Passlet logo into your GitHub App's settings using the new illustrated instructions.
- Nix/Home Manager installations start the Approver at login even before the Nix store is mounted.
- The bundled agent skill now requests missing GitHub permissions directly and offers forwarded SSH access for repositories where you cannot install your GitHub App.
Existing credentials and pairings are preserved. No migration is needed. Resuming an interrupted initial setup after organization approval is not yet supported.
v0.8.0
Passlet can now forward your Mac's SSH agent to a paired Agent on demand, so remote shells and sudo can use your keys without a persistent SSH tunnel. Passlet holds no SSH private keys, and the upstream agent keeps control over which keys are available and whether signing requires Touch ID.
- Run
passlet ssh-agenton a Linux Agent, or enableprograms.passlet.sshAgent.enablein Home Manager for a systemd socket that starts Passlet only when a client connects. PointSSH_AUTH_SOCKat~/.local/share/passlet/ssh-agent.sock. - Configure the upstream socket on the Approver Mac with
ssh_agent_socketinapprover.toml, orprograms.passlet.service.sshAgentSocketin Home Manager. Forwarding stays disabled until this is set. - Only key listing and signing are forwarded. Adding or removing keys, locking, and agent extensions are refused. Every request is checked against the Agent's pairing before and after it reaches the upstream agent, so revoking an Agent blocks it immediately.
- Works with
security.pam.sshAgentAuthon NixOS, sosudoin a remote shell authenticates through your Mac's SSH agent. - Healthy Tailscale listener output in
passlet approver doctorno longer repeats the pairing instructions.
Upgrade both the Approver and its Agents. Existing pairings are preserved and no migration is needed. See the SSH-agent forwarding setup.
v0.7.1
Passlet now explains socket access failures in coding-agent sandboxes and preserves Git proxy authentication when running commands with scoped credentials.
- HTTPS Approver connections, including pairing, can use an environment-configured proxy while retaining pinned TLS authentication. Unix sockets remain direct.
- Codex connection denials receive sandbox guidance without masking missing sockets, refused connections, or timeouts.
- Doctor treats the default socket on Linux as a forwarded connection and gives SSH troubleshooting advice when it is missing or stale.
- Socket permission errors identify the path and explain that sandbox restrictions may block access even when the Approver is running.
passlet execpreserves Git's proxy authentication method while continuing to replace ambient credential helpers with the scoped Passlet grant.- Setup documentation covers sandbox socket access, macOS trust-service restrictions, the Tailscale GUI CLI wrapper, shared SSH connections, sandbox resets, and Nix-managed plugin cache conflicts.
v0.6.1
Local setup now gets your Agent ready to use Passlet without a separate pairing ceremony. Successful passlet approver github setup reuses existing keys, pairs the local Agent, and switches its saved connection to this Mac. Revoked Agents still require explicit pairing.
- Doctor approval dialogs identify the paired Agent requesting the check.
- Pairing instructions show separate commands for the default socket, including SSH-forwarded sockets, and Tailscale. Tailscale discovery failures are reported instead of silently omitting the address.
passlet pairnow takes--endpoint <endpoint>instead of a positional endpoint. Omit the flag to use the default socket. Update scripts that use the positional form.- NixOS integration tests exercise local, SSH, and remote TLS pairing, revocation, re-pairing, restart persistence, and invalid or denied invitations.
v0.6.0
Pair Agents with a one-time command instead of copying public keys into configuration files. Run passlet approver pair on your Mac, use the printed passlet pair command on the Agent, and approve with Touch ID. Pairing saves the endpoint and trusted keys locally, and survives Home Manager rebuilds.
- Pairing codes expire after ten minutes and work once. Each code pins the Approver's identity before the Agent sends its secret, and every credential request still requires approval.
- List trusted Agents with
passlet approver agents listand revoke one withpasslet approver agents revoke <name>. Revocation applies to subsequent requests without restarting the Approver. - Pairing approval does not unlock provider credentials. Local Agents, SSH-forwarded sockets, and Tailscale all use the same pairing flow and authenticated TLS connection.
Upgrade both the Approver and its Agents. passlet connect has been removed. Remove declarative Agent keys, endpoints, and private-key paths from Home Manager, retain installation and service settings, and pair each Agent again, including Agents on the Mac. Existing private keys at the default paths are preserved. See pairing and migration instructions.
v0.5.0
Passlet now pairs Agents with their Approver using Ed25519 keys. Every connection is authenticated and encrypted, including local and SSH-forwarded sockets. Approval prompts identify the Agent by its trusted key label, and captured traffic cannot be replayed to request access. Each credential request still requires Touch ID.
- Missing private keys are generated automatically using Go’s standard library. Public keys are exported for pairing, and existing private keys are preserved.
- Home Manager can declare Agent endpoints, trusted public keys, and private-key paths. Private keys stay outside the Nix store.
- Local and SSH Agents share one socket. Tailscale forwards encrypted traffic through loopback, avoiding the GUI app’s restrictions on Unix sockets.
- Doctor reports the Passlet version, explains pairing and Tailscale failures, and includes an issue-reporting link on errors.
Upgrading from v0.4.x requires updating both the Approver and its Agents and configuring pairing, including for Agents on the same Mac. Remove ssh from approver.toml or programs.passlet.service.ssh from Home Manager, and point SSH forwards at the shared passlet.sock. If port 17400 has an existing Passlet HTTPS proxy, remove that route before enabling the new TCP forwarding. See the pairing and migration instructions and Tailscale setup.
v0.4.2
What's Changed
- chore: Publish v0.4.0 package definitions by @zupo in #34
- fix: Align plugin versions with app releases by @zupo in #35
- fix: Clarify the doctor approval prompt by @zupo in #36
- fix: Include package metadata in release tags by @zupo in #37
- chore: Prepare v0.4.1 package definitions by @zupo in #38
- fix: Prepare v0.4.2 in one release PR by @zupo in #39
Full Changelog: v0.4.0...v0.4.2