The Problem: Workstation Entropy

Developer workstations are highly dynamic environments, prone to accumulating sensitive credentials across a multitude of unencrypted files, configuration stubs, and source code repositories. This "workstation sprawl" creates a significant attack surface, despite best-effort pre-commit security tooling in CI/CD pipelines. Project stash-house addresses this post-sprawl remediation challenge, offering a reproducible framework for local secret hygiene and encrypted stewardship.

Core Operational Primitives

Stash House leverages standard UNIX tooling to establish a robust local-first credential management system:

The core principle is to treat the workstation as the definitive source of truth for credentials, with strong encryption at rest and a clearly defined materialization boundary.

Interactive Terminal Demo: 4-Phase Workflow

Experience the Stash House workflow firsthand with this interactive terminal simulator. Click through the tabs to see how exposed credentials are discovered, secured, and safely used.

Stash House Resource Catalog

Explore the full suite of Stash House project assets, including the white paper, presentation slides, and supporting documentation.

White Paper

The complete 8-page manuscript detailing the Stash House architecture, implementation mechanics, and experimental extensions.

PDFResearch8 pages
Download PDF

LaTeX Source Code

The full LaTeX source file for the white paper, including all figures, references, and custom commands.

LaTeXSource Code
View Source

BSides Colorado Slides

Presentation deck from BSides Colorado, focusing on local credential hygiene and developer workflow integration.

SlidesConferencePDF
Download Slides

Executive Summary Slides

A concise slide deck for leadership and executive briefings, highlighting key security benefits and operational impact.

SlidesOverviewPDF
Download Slides

Stash.drawio Diagram

The editable source file for the Stash House architecture diagram.

DiagramSource
Download Diagram

Password Store Readme

Detailed guide on setting up and using the pass utility for local secret management.

GuideUtility
View Readme

Keyringer Markdown

Documentation on integrating keyringer for collaborative secret management.

GuideCollaboration
View Markdown

Experimental Extensions (Section 6)

The following features are advanced research prototypes for distributed transport and federated quorum, outlined in Section 6 of the white paper. They are optional and operate independently of the core local workstation hygiene toolchain:

  • Nostr NIP-78 Transport: Decentralized ciphertext synchronization.
  • FOKS Key Brokerage: Hardware security key integration for decryption governance.
  • Enterprise Identity Bridge: Interoperability with LDAP/Kerberos.

These extensions are for multi-environment mobility and are not required for core stash-house operation.