Skip to content

Saturate/doorman

Repository files navigation

Doorman

A simple session launcher that reads credentials from 1Password and opens RDP and SSH sessions in one click.

Requirements

  • 1Password desktop app (v8+)
  • 1Password Settings → Developer → Integrate with other apps enabled
  • Windows App for RDP sessions (macOS)

Setup

pnpm install
pnpm dev

How it works

Doorman uses the 1Password SDK with DesktopAuth — no service account or API token needed. It authenticates through the local 1Password desktop app using your existing session and biometrics.

Items are loaded from all vaults simultaneously. Only RDP and SSH items are shown — web logins are intentionally excluded since 1Password handles those via the browser extension.

Item conventions

Doorman detects session types based on how items are stored in 1Password:

Session Category Website URL
RDP Login rdp://hostname
SSH Login ssh://user@hostname
SSH Server (any)

For SSH Server items, Doorman looks for hostname/host/address/IP and username fields to build the connection URL.

Logs

Logs are written as JSONL to:

# macOS
~/Library/Logs/Doorman/doorman.log

# Windows
%APPDATA%\Doorman\logs\doorman.log

The file is truncated on startup if it exceeds 10 MB.

Pretty-print with: tail -f ~/Library/Logs/Doorman/doorman.log | npx pino-pretty

About

1Password-powered session launcher for RDP and SSH

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors