Shelfbox keeps private files visible inside Git projects
Shelfbox materializes private, local-only files into their expected project paths while keeping the actual content stored outside the repository, so tools and IDEs can find them without Git tracking. Developed by masa-kjm as a command-line utility for Windows, the tool targets developers, AI engineers, and power users who need local AI context, private configs, or notes inside shared repositories. Installation options include WinGet or a standalone installer, and the interface is a lightweight CLI for scripted workflows.
How Shelfbox prevents accidental commits while keeping files discoverable
The app stores canonical file content in a central location outside the Git tree and then places placeholder files at the original paths so local tools can discover them. That arrangement keeps the repository free of sensitive payloads because the app manages visibility at the filesystem level rather than by editing .gitignore entries. The materialization step restores files to their expected paths, and the tool includes recovery support for worktrees and new clones.
How it interacts with the system during materialization and recovery
Shelfbox is written in Rust and exposes a command-line interface, which contributes to a lightweight runtime and fast startup. The implementation focuses on file metadata and content mapping rather than heavy background services, so operations run on-demand when you invoke the CLI. Recovery across worktrees and after recloning is handled by the tool's external storage model, which maps canonical copies back into the repository structure when requested.
Whether Shelfbox is safe to use in shared repositories
The app keeps file contents outside the repo and manages local visibility, which reduces accidental commits of private data. It does not depend on editing repository ignore lists to achieve that outcome. Because the workflow operates from the CLI, it requires the user to run the materialize and recovery commands explicitly, giving the operator control over when private files are exposed inside a working tree.
Who benefits and a practical setup tip
Shelfbox fits developers and AI engineers who accept command-line workflows and need local-only files discoverable by tools without altering the repository history. It requires familiarity with CLI tools and Git worktrees to get full value; casual GUI-only users may face a learning curve. Install via the Windows Package Manager for a straightforward setup, then script materialization steps into your local development hooks for consistent behavior. Recommended.
