Developer gesposito has released Dotfactory, a Claude Code plugin that aims to solve the cold-start problem in AI coding sessions by persisting user preferences and tool definitions. Unlike traditional configuration files that sit idle, Dotfactory actively injects context into every new session, ensuring that Claude knows how you like your code formatted and which specialized agents or repos are available to you.

The 'Brain' Concept

The core architecture revolves around a local directory called the 'brain,' which contains markdown files defining preferences, tools, and project history. This brain is entirely separate from the plugin repository, allowing users to version control their personal configurations independently. Preferences can be global or scoped to specific project types using marker files like Cargo.toml, while tools can be defined as local repositories, external expert sessions, or simple notes.

Integration and Workflow

Installation is straightforward via the Claude plugin marketplace, with support for testing from a local checkout. The plugin integrates deeply with the Claude Code interface, offering a dedicated pane accessible via keyboard shortcuts or mouse clicks. This pane provides quick access to commands like /dotfactory:new for scaffolding projects, /dotfactory:remember for saving preferences, and /dotfactory:add-tool for registering new capabilities. The system is designed to be agnostic to programming languages, relying instead on user-defined markdown to bridge the gap between general-purpose AI and personal workflow habits.

Technical Constraints and Early Access

Dotfactory is currently tested with Claude Code version 2.1.330 and requires at least version 2.1.287. It leverages Claude Code's mods API, which is in early access and subject to change. A notable technical constraint is the 10,000-character cap on session-start output, meaning users must keep their preference files concise to avoid truncation. The plugin includes a suite of tests for both the pane interface and shell scripts, emphasizing stability despite the volatile nature of the underlying API.

Key Takeaways

  • Dotfactory uses a local 'brain' of markdown files to persist user preferences and tool definitions across Claude Code sessions.
  • The plugin supports multiple tool types, including local repos, external expert sessions, and static notes, allowing for flexible workflow customization.
  • It requires Claude Code 2.1.287+ and uses the early-access mods API, with a 10k character limit on session-start context.
  • Configuration is language-agnostic, using marker files to scope preferences to specific project types like Rust or Node.js.

The Bottom Line

Dotfactory represents a necessary step toward making AI coding assistants truly personal; by externalizing context into a manageable, versioned 'brain,' it moves beyond one-off prompts to a persistent, opinionated development environment. This approach reduces the cognitive load of re-explaining preferences, though developers should watch the character limits closely as their brains grow.