Skip to content

msun68/pass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pass (simple password manager)

Commands

  • pass init — initialize the password store; prompts for a passphrase and creates config under the OS user config dir (e.g., ~/Library/Application Support/pass/config.json on macOS)
  • pass serve — start the in-memory agent over a UNIX socket to cache the derived key
    • Env: PASS_AGENT_TCP_ADDR=127.0.0.1:5959 (optional TCP), PASS_AGENT_TOKEN=... (required when TCP enabled)
  • pass add — prompts for passphrase and password; stores encrypted under
  • pass — prompts for passphrase, decrypts, and prints the password

Details

  • Key derivation: Argon2id with the hostname as salt (64 MiB, t=3, p=1)
  • Encryption: AES-GCM; payload stored as base64(nonce||ciphertext) in JSON
  • Config path: os.UserConfigDir()/pass/config.json
  • Agent socket: os.UserConfigDir()/pass/agent.sock (0600)
  • Client envs: PASS_AGENT_ADDR (unix:/path.sock or tcp:host:port), PASS_AGENT_TOKEN (for TCP)
  • Container usage: run pass serve on host with PASS_AGENT_TCP_ADDR set; in container set PASS_AGENT_ADDR=tcp:host.docker.internal:PORT and PASS_AGENT_TOKEN to match

Schema (v6 only)

  • version: 6
  • vault.seal: base64(nonce||ciphertext) for token "ok"
  • vault.entries: object mapping name -> base64(nonce||ciphertext)

Build

  • go build

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages