Repo of the Day
gesposito/dotfactory
Published: Nov 22, 2026
Open repository ↗A personal project factory for Claude Code: your preferences, tools and expert sessions, loaded into every session
Summary
dotfactory is a Claude Code plugin that gives every session access to your personal preferences, tools, and project records. It stores that information as Markdown in a separate “brain” folder, making it reusable across repositories without embedding personal context in each project.
What it is useful for
The plugin is useful when engineers repeatedly give Claude Code the same guidance, such as naming conventions, licensing choices, or a preference to avoid unnecessary dependencies. Preferences can apply everywhere, or only to projects containing a marker file—for example, a Rust-specific file with markers: Cargo.toml.
It also provides a consistent way to expose reusable jobs to a session. A tool can point to:
- A repository whose commands Claude Code can run.
- An expert Claude Code session that can answer questions.
- Written notes containing the steps for a task.
This makes dotfactory useful for repeatable project setup, team or personal workflow guidance, and access to existing code without tying the plugin to a particular language or framework. Sessions automatically receive applicable preferences and a summary of registered tools. Projects created with /dotfactory:new are also recorded in the brain.
How engineers can use it
Install the plugin with the documented commands:
claude plugin marketplace add gesposito/dotfactory
claude plugin install dotfactory@dotfactory
The brain is stored in the first available location: the folder named by DOTFACTORY_BRAIN, a brain directory beside a checkout’s plugin directory, or ~/.config/dotfactory/brain. It is created when something is first saved. The README recommends making it its own Git repository to retain history.
Typical commands include:
/dotfactory:remember <preference>
/dotfactory:add-tool <path>
/dotfactory:add-tool session <name>
/dotfactory:add-tool <what the notes cover>
/dotfactory:new
/dotfactory:status
/dotfactory
For example, after registering a repository as a tool, a new project session can use it during setup. Registering an expert session named namer allows Claude Code to consult that session for project-name suggestions. Expert sessions must remain running to answer, so they cannot be treated as offline resources.
The /dotfactory command opens a pane with controls for project creation, remembering preferences, adding tools, and checking status. In VS Code, use the mouse or keyboard navigation; digit shortcuts are documented as terminal-only.
There are several constraints. The pane requires Claude Code 2.1.287 or later, while the README says the project was tested with 2.1.330. It relies on an early-access mods API that may change between releases. Session-start output is capped at 10,000 characters, so long preference files can be truncated and should remain short.