Memento Protocol: The zsh for Claude Code

Transform Claude Code from a basic AI assistant into a project-aware, context-intelligent development powerhouse.

The Problem

Claude Code breaks down as your codebase grows:

• 😔 Re-adding the same CLAUDE.md instructions across projects
• 📝 Claude spams markdown files instead of organized task tracking
• 🔄 Goes in circles after context compacting, repeating failed approaches
• 🎭 Copy-pasting roleplay prompts: "Act as engineer..." "Be a reviewer..."

The Solution: oh-my-zsh for AI

Just as zsh transformed terminals with themes and plugins, Memento Protocol transforms Claude Code with:

# Before: Basic Claude Code
"Please review my code"  # Generic responses

# After: With Memento Protocol
/mode reviewer          # Specialized AI personality
"Review the auth module" # Context-aware, focused analysis

See It In Action

# 1. Install (30 seconds)
npx memento-protocol init

# 2. Use enhanced features immediately
/mode architect         # Switch to system design mode
/ticket create "Add authentication"  # Persistent task tracking
/memento               # See project status

# 3. Claude becomes context-aware
"Implement the auth feature"  # Claude knows about your ticket, 
                              # project structure, git status, etc.

Core Features

Feature	What It Does	zsh Equivalent
AI Modes	Switch personalities (architect/engineer/reviewer)	Themes
Tickets	Persistent task tracking across sessions	tmux sessions
Fuzzy Matching	/mode eng → finds engineer	Smart completions
Hooks	Auto-load context, expand acronyms	precmd/preexec
Workflows	Reusable procedures (review, deploy, audit)	Functions
Agents	Specialized tools (research, analysis)	Plugins

Quick Start

Basic Setup

npx memento-protocol init

With Recommendations

npx memento-protocol init --all-recommended

Global Install

npm install -g memento-protocol
memento init

Starter Packs: Ready-to-Use Bundles

Get up and running instantly with curated collections of modes, workflows, and agents:

# Install with automatic detection
npx memento-protocol init --starter-pack

# Or specify a pack directly
npx memento-protocol init --starter-pack frontend-react

Available Packs

Pack	Description	Includes
frontend-react	Complete React development setup	component-engineer, react-architect, ui-reviewer modes + creation workflows
backend-api	RESTful API development	api-architect, backend-engineer, security-reviewer modes + testing workflows
fullstack	End-to-end development	Both frontend and backend capabilities combined

Just like oh-my-zsh themes transform your terminal experience, starter packs transform Claude Code for your project type.

Daily Workflow

# Morning: Architecture & Planning
/mode architect
"Design the payment system"

# Afternoon: Implementation  
/mode engineer
"Implement stripe integration"

# Evening: Review
/mode reviewer
"Check for security issues"

# Track Everything
/ticket list                    # See all tasks
/ticket view payment-system     # Load full context

Why It Works

Problem: Claude Code loses context and repeats mistakes
Solution: Persistent tickets + smart hooks = continuous context

Problem: Same prompts copy-pasted everywhere
Solution: Built-in modes with best practices baked in

Problem: Scattered markdown files everywhere
Solution: Organized ticket system with clear status tracking

Documentation

• 📚 Installation Guide - Detailed setup instructions
• 🚀 Quick Start - Get running in 5 minutes
• 📦 Starter Packs Guide - Ready-to-use bundles for different project types
• 🎨 Creating Modes - Build custom AI personalities
• 🔧 Workflows - Automate complex tasks
• 🪝 Hooks Guide - Event-driven automation
• 📖 API Reference - Programmatic usage

Examples

Switch Modes with Fuzzy Matching

/mode arc      # → architect
/mode eng      # → engineer  
/mode apm      # → autonomous-project-manager

Create and Track Tasks

/ticket create "Add user authentication"
/ticket move auth-task in-progress
/ticket resolve auth-task

Auto-Expand Acronyms

memento acronym add API "Application Programming Interface"
memento acronym add DDD "Domain-Driven Design"
# Now Claude automatically understands your project's terminology

Philosophy

Like zsh enhances bash without replacing it, Memento Protocol enhances Claude Code while preserving everything that works. Start simple, add power as needed.

Coming Soon

• 🌍 Community Hub: Share modes and workflows
• 📝 ~/.memento/config.yaml: Global config file (unified structure with project config)
• 🔌 Plugin Manager: Easy install/update (like zplug)
• 📊 Analytics: Track productivity and usage patterns

Star History

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Support

• 🐛 Issues
• 💬 Discussions
• 📖 Wiki

License

MIT © Memento Protocol Contributors

---

⭐ Star us if this solved your Claude Code problems!
Transform your AI coding experience in 30 seconds