CLI soul.md design and management system for agentic programming
npm install -g soul-keeper
The Concept
A persistent conscience for your AI coding assistant
A markdown file that captures who you are as a developer — your values, preferences, working style, and technical philosophy. The same way you'd onboard a human colleague.
Give your AI assistant persistent context that survives across sessions. No more repeating "I prefer TypeScript" or "I always write tests first" every single conversation.
Create project extensions that capture what makes each project unique — the tech stack, architecture decisions, team dynamics, and special requirements.
Give your AI a conscience — a persistent set of values and principles that guides every coding session
Getting Started
Three simple commands to establish your AI's conscience
Interactive prompts help you build a comprehensive soul.md covering your identity, values, tech stack, working style, and AI collaboration preferences.
For each project, create a specialized soul that inherits your base while capturing what makes that project unique. Perfect for different tech stacks and team dynamics.
Push your soul to GitHub and access it from any machine. Your AI's conscience follows you across all your development environments.
Reference
Everything you need to manage your soul