Menu
On this page

How Passlet works

Understand Agents, Approver, and how scoped credentials reach your coding tools.

Passlet gives coding agents short-lived, scoped GitHub access after you approve a request on your Mac. Approver keeps the long-lived credentials in your Mac’s protected Keychain. Agent runs beside your coding tools, locally or on another machine.

Install Agent

Approver requires macOS. Agent supports macOS and Linux. Follow the installation guide to configure Approver and set up GitHub first.

Agent on macOS

The Homebrew cask includes both Approver and Agent:

brew tap paretosecurity/passlet https://github.com/ParetoSecurity/passlet.git
brew install --cask paretosecurity/passlet/passlet

Agent on Linux

Install Agent with Homebrew:

brew tap paretosecurity/passlet https://github.com/ParetoSecurity/passlet.git
brew install paretosecurity/passlet/passlet-agent

You can also use Nix or Home Manager.

How credentials move

sequenceDiagram
accTitle: Scoped GitHub access through Passlet
accDescr: Agent requests scoped access from Approver. After native approval on the Mac, Approver requests a token from GitHub and delivers it to Agent. Agent then uses GitHub directly.
participant Agent
participant Approver as Approver on your Mac
participant User as You
participant GitHub
Agent->>Approver: Request repositories and permissions
Approver->>User: Request native approval
User->>Approver: Approve with Touch ID
Approver->>GitHub: Request scoped token
GitHub-->>Approver: Expiring token
Approver-->>Agent: Scoped token
Agent->>GitHub: Use approved access directly

The connection between Agent and Approver uses paired keys. It can run over a local Unix socket, an SSH-forwarded socket, or Tailscale. See pairing and Tailscale configuration.

What happens if your Mac goes offline?

Access after disconnection

Merged, not yet released

Delivered tokens continue working until they expire. Sessions under the same OS user can reuse matching grants from the Agent’s private file cache while Approver is offline. Issuing a new token requires Approver to be online and your approval. Use request --no-cache to bypass cache lookup and storage. Passlet does not approve new tokens unattended.

Next steps