Pre-release preview. credsd is provided as a pre-release preview in coordination with Strands Box. Commands, configuration, the socket API, and on-disk formats can change between releases, and a change does not necessarily come with a migration path. The on-disk layout may change without a migration. Windows is for ease of use only: there is no process-tree assessment, and
servedoes not run there yet.
credsd is a local credential daemon for developers and for the agents and tools they run. It holds long-lived secrets — SSO sessions, IAM user keys, Roles Anywhere private keys, OAuth and bearer tokens — sealed under a master key in a hardware or OS keystore, and vends short-lived material to processes on request. The daemon is the only process that opens the keystore; the client asks it over a Unix socket, the daemon authorizes the caller by kernel-verified peer uid, and every request is assessed and audited there.
credsd is not a general-purpose secret store like HashiCorp Vault, and not a password manager.
Holding secrets is one part of what it does. It also exchanges them for short-lived
credentials, groups credentials into named environments, delivers each one in the form its
consumer reads, and requires a Touch ID or sudo approval before anything changes them.
Everything it holds belongs to one user on one machine. See the overview.
| Binary | Role | Subcommands |
|---|---|---|
creds |
Client | bootstrap, login, get, list, remove, config, import, request, presence |
credsd |
Daemon | serve, init, install, uninstall, status |
- Evaluating credsd: Overview, then Key security.
- Setting it up: Getting started.
- Choosing an install shape: Install.
- Approving a change: Presence and sudo approval.
- Every command and flag: Command reference.
- Files, keys, and environment variables: Configuration reference.
- Talking to the socket directly: API reference.
- Reviewing custody and threat model: Key security.
| Platform | Install shape | Storage backend |
|---|---|---|
macOS, official signed release (credsd-macos-aarch64.pkg) |
User-scoped (LaunchAgent), credsd install --user |
data-protection-keychain |
| macOS, built from source | System (LaunchDaemon), sudo credsd install |
secure-enclave |
| Linux | System (systemd) | tpm |
| Windows | Not yet decided | — |
See Install for what each shape protects.
Apache-2.0