peach-browser
A free, open source, local-first password manager for Chrome, Firefox, and Android.
TypeScript
timeline
atlas266 files
public/
codex/
fonts/
models/
scripts/
build-peachscript.pyBuild PeachScript-Regular.otf — 256 historical-runic glyphs.ci.tsclean-chrome-dist.mjsclean-firefox-artifacts.mjspackage-amo-source.shpackage-amo-source.sh — produce peach-3.6.65-source.zip for AMO review.release-firefox.tsrelease.tssetup-chrome-release.sh───────────────────────────────────────────────────────────────────────────── Peach — Chrome Web Store Release Setup Run this once to configure Chrome publishing.sync-chrome-dist.mjs
src/
background/
aes.test.tsaes.tsaes.ts — AES-256-GCM encrypt/decrypt primitives for vault storage.alarms.test.tsalarms.tschirp-identity.tsLocal-device identity helpers for the chirp-sync architecture.chirp-sync-coordinator.test.tschirp-sync-coordinator.tsChirp Sync — Phase 2 manifest-diff coordinator.chirp-sync-runner.test.tschirp-sync-runner.tsProduction sync runner — composes the live vault adapter, WebSocket transport, and coordinator into the function the dispatcher injects via
setSyncRunner.chirp-sync-static.test.tsIV.7 — Static safety assertions for Chirp Sync.chirp-sync-vault-adapter.test.tschirp-sync-vault-adapter.tsProduction adapter that backs runChirpSyncInitiator with the live vault.clipboard.test.tsclipboard.tscodex-handlers.test.tsTests for src/background/codex-handlers.ts.codex-handlers.tscodex-handlers.ts — message handlers that back the Peach Codex flow.commands.tsKeyboard command handler — routing for summon-inline: 1.entry.tshealth.test.tshealth.tshealth.ts — Pro advanced vault health analysis.index.tslicense.tsmessages.adversarial.test.tsmessages.adversarial.test.ts — Layer 3 §3.3 adversarial message handler tests.messages.test.tsmessages.tsmessages.ts — the only background message handler.ml.tsnotes.test.tspaired-devices.test.tspaired-devices.tsPaired-device registry — v3 chirp-sync.passkey-chrome-ceremony.test.tspasskey-chrome-ceremony.test.ts — covers the Chrome chrome.webAuthenticationProxy ceremony path that the Firefox-proxy test file does NOT exercise.passkey-crypto.test.tspasskey-crypto.tspasskey-deny-on-close.test.tspasskey-deny-on-close.test.ts — M8/COR-009passkey-firefox-proxy.test.tspasskey-firefox-proxy.test.ts — covers the v2.12.0 Firefox content-script proxy path.passkey.tsrecovery-pending.tsPersistent flag set while the user has just created a vault and is reading their 12 recovery words but has not yet typed the 3 confirmation words.recovery-words.test.tsrecovery.adversarial.test.tsrecovery.adversarial.test.ts — Layer 3 §3.2 adversarial recovery words tests.self-test.test.tsself-test.tsself-test.ts — Known-Answer Test (KAT) for the Peach crypto stack.sync-trigger.test.tssync-trigger.tssync-trigger.ts — central sync dispatcher.vault-history.test.tsVault history tests.vault.adversarial.test.tsvault.adversarial.test.ts — Layer 3 §3.1 adversarial vault tests.vault.test.tsvault.tsvault.ts — sole owner of vault state and chrome.storage vault keys.content/
passkey-toast/
crypto/
argon2.test.tsargon2.tscrypto.test.tspeachPayload.test.tspeachPayload.tspeachPayload.ts — binary payload format shared by PeachScript and the Peach QR matrix code (spec §2).peachScript.test.tspeachScript.tspeachScript.ts — PeachScript encoding/decoding.totp.tszstd.tsThin wrapper around @bokuweb/zstd-wasm that defers WASM load until the first compress/decompress call and memoises the init promise.
popup/
codex/
aztec.tsaztec.ts — Aztec 2D barcode generation with round-trip verification.browser-bundle.test.tscodex.adversarial.test.tscodex.adversarial.test.ts — Layer 3 §3.4 adversarial Codex tests.codex.suite.test.tscodex.suite.test.ts — cross-cutting regression suite for the Codex pipeline.codex.test.tsconfirmation.tsPick 3 distinct positions in [1, 12] for the recovery-words confirmation gate.erasure.tserasure.ts — Reed-Solomon erasure coding around the WASM library.generate.test.tsgenerate.tsgenerate.ts — full Codex generation pipeline.helpers.tshelpers.ts — shared utilities for Codex generation and restoration.node-wasm.tsNode-only WASM byte loader for Vitest.pdf-import.test.tspdf-import.test.ts — coverage for the testable surface of the PDF import path.pdf-import.tspdf-import.ts — restore from a Codex PDF instead of a camera scan.pdf-layout.tspdf-layout.ts — A4 Codex page geometry shared between the generator and the PDF importer.pdf.tspdf.ts — render the printable Codex PDF.reed-solomon.tsBrowser-safe wrapper around the Reed-Solomon WASM exports.restore.test.tsrestore.test.ts — coverage for ChunkBuffer, parseRawScan, reconstructAndVerify.restore.tsrestore.ts — Peach Codex restoration library (popup-side).rs-loader.tsrs-loader.ts — load the Reed-Solomon erasure WASM module.scanner.tsscanner.ts — camera-based Aztec scanning for Codex restoration.
components/
views/
Add.tsxChirpSync.tsxChirpSync — the v3 Settings → Sync surface.CodexGenerateView.test.tsx@vitest-environment jsdomCodexGenerateView.tsxPeach Codex — generation view.CodexRestoreView.tsxPeach Codex — restoration view.contracts.test.tsx@vitest-environment jsdomEntry.tsxExport.tsxSignal-conditioned views in this file must use <Show>, never a signal-conditioned early return (
if (signal()) return <X/>).Health.test.tsx@vitest-environment jsdomHealth.tsxImport.tsxSignal-conditioned views in this file must use <Show>, never a signal-conditioned early return — see Projects.md §4.1.Lock.tsxNoteEditor.toHtml.test.ts@vitest-environment jsdomNoteEditor.tsxNotesEditor.tsxNotesMode.tsxNotesTOC.tsxOnboarding.tsxPanic.tsxPasskeyApproval.tsxProCelebration.tsxRecoveryWordDisplay.tsxRecoveryWordEntry.tsxSettings.tsxTrashView.tsxVault.tsxview-test-utils.tsxshared/
backup.test.tsbackup.tsbridge.tsbrowser.test.tsbrowser.test.ts — locks down feature-detected browser identification.browser.tsbrowser.ts — feature-detected browser identifier shared by background, popup, and content scripts.chirp-handshake.test.tschirp-handshake.tsPost-chirp pairing handshake.chirp-pairing.test.tschirp-pairing.tsAudio pairing driver — orchestrates the two-chirp exchange that bootstraps trust between two devices in the same room.chirp-payload.test.tschirp-payload.tsAudio pairing payload — 64 bytes on the wire.chirp-sync-transport.test.tsSubnet-probe rate-limit tests.chirp-sync-transport.tsWebSocket sync transport — v3 chirp-sync Phase 2.codex-types.tscodex-types.ts — shared shapes for the Peach Codex.config.tsTemporary until Vesper (internal tracker) is readydevice-manifest.test.tsdevice-manifest.tsDevice manifest — v2 brief §4.3.domain.tsfavicon.test.tsfavicon.tsResolves a favicon URL for a given domain.generate.test.tsgenerate.tsggwave.test.tsggwave.tsggwave loader — thin async wrapper around the ggwave-wasm module.import.test.tsimport.ts
any is intentional throughout this module (L17/I3/QUA-010): import files are user-supplied external JSON whose schemas vary by source app and version (1Password CPG, Bitwarden, CXF, generic CSV).local-network.tsLocal network discovery — minimal helper used by chirp pairing.ml.tsnative.tsMobile platform detection helpers used by popup views to gate Capacitor-only paths.noise-js.test.tsNoise NK auth proof regression test.noise-js.tsNoise NK initiator for Android / Capacitor.noise-xx.test.tsnoise-xx.tsNoise XX (mutual auth) — used for every Phase-2 WebSocket connection after the audio chirp pairing has stamped each side into the other's paired-device registry.passkey-flags.tspasskey-flags.ts — single switch for the Firefox passkey content-script proxy.recovery-word-list.tsrecovery-word-list.ts — 2048-word recovery word list for Peach vault recovery.recovery-words.tsrecovery-words.ts — BIP39-compatible recovery word encoding for Peach vault recovery.shortcuts.test.ts@vitest-environment jsdomshortcuts.tsshortcuts.ts — keybinding schema, defaults, matcher, formatter.storage.tssync-identity.test.tssync-identity.tsSync identity — long-term X25519 keypair tied to the vault, not the device installation.sync-types.tsChirp Sync — type definitions (Master Brief v2).types.tstypes.ts — cross-boundary types and the MessageType union.tests/
fixtures/
history
4da393b64b5dserialize lock/restore with vault epoch and awaited escrow clear (PB-26-204, v5.0.58)1 month ago1f5db0955af7docs: record PB-26-202 remediation save1 month ago3007c77c652efix: stop passive global identity disclosure (PB-26-202, v5.0.57)1 month agoa7ed252fcbefdocs: record PB-26-201 remediation save1 month ago9b061a75009afix: enforce browser-issued autofill authority (PB-26-201, v5.0.56)1 month ago287e1fd0b13fconsume summon capability on same-domain fill and bump to v5.0.551 month agod7d47c3cc1d2PB-26-201 discriminating authorization tests pass with v5.0.541 month ago151df7df811cPB-26-201 authorization boundary and capability remediation (v5.0.54)1 month ago9371b98e40b5docs: Specify resolutions for PB-26-201 through PB-26-213 (v5.0.53)1 month ago764c331e1331record the corrected remediation campaign in CONTINUITY.md and retire the stale handoff (v5.0.53)1 month ago3feff5b04e3crecord PB-26-104 as resolved and the peach-pair-v2 invitation compatibility cut in AGENTS.md (v5.0.52)1 month agofb40727c5334add popup TOTP parameter and legacy trustSource provenance regression tests (PB-26-114, PB-26-116, v5.0.51)1 month agoac6674472a01add bounded SYNC_REQUEST and import size guard regression tests (PB-26-111, PB-26-112, v5.0.50)1 month agod485bbc3e255add regression tests for passive auto-lock refresh and passkey offer-decline origin binding (PB-26-107, PB-26-109, v5.0.49)1 month ago0b68b0540185add the recovery window deadline sequence test: alarm and idle lock after expiry and the words need a password proof (PB-26-102, v5.0.48)1 month ago9189870090c5bump the pairing invitation prefix to peach-pair-v2 with the pinned static now mandatory (PB-26-103, v5.0.47)1 month ago056807d6a42emove the locked-sync spool to session storage so locked sync keeps working without a disk-resident key (PB-26-104, v5.0.46)1 month ago11473a0cb44fkey the declined-card digest to root-key material and reject legacy unsalted records (PB-26-108, v5.0.45)1 month agoe8d9c9d2d975restore package.json and both manifests truncated by a bad in-place version bump (repair of 0ab2c6b00e92, v5.0.44)1 month ago0ab2c6b00e92enforce the PeachScript import ceiling at encode time on encoded UTF-8 bytes (PB-26-113, v5.0.44)1 month agocd181fe97194evict revocations from the largest-holding issuer so one flood cannot starve another's records (PB-26-110, v5.0.43)1 month agof0ba500e86edbind content-script entry writes to the entry domain set and route remember-site through the popup (PB-26-106, v5.0.42)1 month ago08e9038e7ce8docs: record completed cross-platform assessment remediation saves1 month agofcebf35ed424fix: bind pairing and Noise context and remove locked sync private key (PB-26-103, PB-26-104, PB-26-117, v5.0.41)1 month ago081ae8b38113fix: preserve terminal revocations against peer floods and retain local revoke capacity (PB-26-110, v5.0.40)1 month ago65263d57b9a4fix: preserve legacy trustSource and bound sync request IDs before crypto (PB-26-111, PB-26-116, v5.0.39)1 month ago6dfff89fba08harden browser-local origin, passkey, import, export, TOTP, and metadata boundaries (PB-26-106–114, v5.0.38)1 month agof557c2f0ee93docs: write the 2026-09-01 remediation handoff for the next agent1 month agoa4983770e66cdocs: record the Mercury verification gap and the completed PB-26-105 gate1 month ago17ddf6513cd7gate the TOTP-selector and confirm-password writes behind the form-action decision (PB-26-105, v5.0.37)1 month agoa5153594b717docs: record PB-26-105 completion in CONTINUITY.md1 month agod48cf50b1d35propagate form-action gate to TOTP fill and canary (PB-26-105, v5.0.36)1 month ago5c0a970d298edocs: record 2026-09-01 remediation checkpoint and first resolved findings1 month ago759ec348c2cbtest: align sender fixtures with fail-closed URL policy (PB-26-115, v5.0.35)1 month ago74c52ffb68e6fix: reject URL-less privileged message senders (PB-26-115, v5.0.34)1 month ago44585ddffc10fix: deadline and clear recovery confirmation exemption (PB-26-102, v5.0.33)1 month ago6fbc284fc874fix: preserve purge tombstones across replace restore (PB-26-101, v5.0.32)1 month ago04e8b01a0563docs: publish independent browser security assessment report, coverage ledger, and finding register (v5.0.31 baseline, 17 findings)1 month ago4e319afd62c8record the cross-platform entry-id namespace change and its migration behavior (v5.0.31)1 month agob7ace1e073canaturalise foreign entry ids at the browser restore seam instead of trusting them (v5.0.31)1 month agoa33df62c91d3docs: PB-26-018 resolved and ready for next AMO submission (v5.0.30)1 month agofda1a4eb8251align declared Node engine requirement with CI toolchain (audit OBS-03) (v5.0.30)1 month agodb659957fb69fix: E2E harness respects Chromium executable override and tests WebCrypto directly (audit OBS-02)1 month ago6bf8cebf3f01fix: Firefox release scripts now submit source archive via --upload-source-code (audit PB-26-018)1 month agoa20650466475docs: Publish independent standard security audit1 month agobc6649de8443docs: record Firefox sender-context CI follow-up1 month ago65de4e3e2cc5test: add Firefox sender-context CI coverage (v5.0.27)1 month agoa5aedfd3830edocs: record PB-26 remediation completion (v5.0.25)1 month ago0b2b4a23a099fix: complete PB-26 sender policy compatibility (v5.0.25)1 month ago0af21be3f7f9fix: make PIN unlock session-scoped with attempt limits (v5.0.22)1 month ago
details
Peach
A free, open source, local-first password manager for Chrome, Firefox, and Android.
Peach encrypts your vault on your device. No hosted vault, subscription, or account is required to use it.
Features
- Passwords, cards, and secure notes — keep your private data together in one encrypted vault
- Inline autofill — fill and save credentials without leaving the page
- TOTP built in — generate two-factor codes without a separate authenticator
- Password health — find weak, reused, and exposed passwords
- Portable backups — export and restore with PeachScript or a
.peachfile
Peach Pro adds:
- Peach Sync — end-to-end encrypted sync across paired devices
- Passkeys — save and use passkeys in Chrome and Firefox
- Peach Codex — print an encrypted, scannable backup of your vault
- Advanced vault health, Canary Entries, and duress tools
See the Peach website for current availability and Pro details.
Install
Open Source
Peach is released under the GPL v3. This repository contains Peach's Chrome and Firefox browser extensions. Android is maintained separately.
The source is hosted on Kepr, Asha Software's version control platform.
Security
Vault data is encrypted with AES-256-GCM and protected by Argon2id key derivation. Peach Sync authenticates paired devices and encrypts data in transit.
Implementation details live alongside the code:
Building
bun install --frozen-lockfile
bun run build
Builds are written to dist-chrome/ and dist-firefox/.
Built by Asha Software · [email protected]