@probelabs/memaris

Memaris

Stop re-teaching your AI. Turn past sessions into persistent memory.

Website • Documentation • NPM Package

What is Memaris?

Memaris analyzes your Claude Code conversation history to extract patterns, preferences, and lessons learned. It turns every correction, rejected approach, and successful pattern into permanent memory that follows you across sessions.

The Problem: Every time you start a new Claude Code session, you're teaching the same preferences again. "Don't use sudo with npm." "Prefer async/await." "Always add error boundaries."

The Solution: Memaris reads your past sessions, identifies what worked and what didn't, then creates a personalized CLAUDE.md file with instructions tailored to your coding style.

🚀 Quick Start

# Navigate to your project
cd your-project

# Preview insights (no file changes)
npx -y @probelabs/memaris

# Apply insights to CLAUDE.md  
npx -y @probelabs/memaris --update

That's it! No installation needed - just run and go. Memaris will analyze your Claude Code history and generate personalized instructions.

💡 Pro tip: The first command previews what insights will be added. Use --update to actually modify your CLAUDE.md file.

📖 How It Works

📝 Your Conversations Every correction, preference, and rejected approach in your Claude Code sessions

🤖 AI Analysis Extracts patterns, identifies mistakes to avoid, and learns your coding style

✨ Optimized CLAUDE.md Personalized instructions that make every future session start smarter

🎯 Key Features

• Smart Project Detection - Automatically finds Claude Code conversations in your project
• AI-Powered Analysis - Uses advanced pattern recognition to extract meaningful insights
• Memory Profiles - Creates profiles of your coding style and preferences
• Mistake Prevention - Identifies recurring issues and provides actionable recommendations
• Privacy First - All analysis happens locally, your conversations never leave your machine

📚 Commands

Basic Usage

npx -y @probelabs/memaris                    # Preview insights (default)
npx -y @probelabs/memaris --update          # Apply insights to CLAUDE.md
npx -y @probelabs/memaris /path/to/project  # Analyze specific project

Advanced Options

Option	Description	Example
--update	Write changes to CLAUDE.md (default: preview only)	npx -y @probelabs/memaris --update
--all	Analyze all conversation history in batches	npx -y @probelabs/memaris --all --update
--batch-size <n>	Token batch size when using --all (default: 50000)	npx -y @probelabs/memaris --all --batch-size 25000
--depth <n>	Maximum messages to analyze (deprecated, use --tokens)	npx -y @probelabs/memaris --depth 100
--tokens <n>	Maximum tokens to analyze (default: 50000)	npx -y @probelabs/memaris --tokens 25000
--pattern-only	Use pattern-matching instead of AI analysis	npx -y @probelabs/memaris --pattern-only
--exclude-patterns	Exclude sessions matching patterns	npx -y @probelabs/memaris --exclude-patterns "debug,test"
--debug	Show debug information	npx -y @probelabs/memaris --debug

Pro Tips

# For large projects with lots of history
npx -y @probelabs/memaris --all --batch-size 30000 --update

# Quick analysis for recent work only
npx -y @probelabs/memaris --tokens 10000 --update

# Pattern-only analysis (faster, no API key needed)
npx -y @probelabs/memaris --pattern-only --update

Other Commands

# Discover all Claude Code projects
npx -y @probelabs/memaris scan

# Export analysis results
npx -y @probelabs/memaris export my-project json
npx -y @probelabs/memaris export my-project markdown

# Focus on specific insights
npx -y @probelabs/memaris insights --type preferences

🛠️ Requirements

• Node.js 18+ or Bun runtime
• Claude Code with existing conversation history in ~/.claude/projects/
• Optional: ANTHROPIC_API_KEY for AI-powered analysis
  • Without API key: Uses fast pattern-matching analysis
  • With API key: Uses advanced AI analysis for deeper insights

Environment Setup

# Optional: Enable AI-powered analysis
export ANTHROPIC_API_KEY="your-api-key-here"

# Verify Claude Code history exists
ls ~/.claude/projects/

Note: Memaris works great with pattern-matching analysis (no API key required), but AI-powered analysis provides much richer insights.

🔧 Development

# Clone the repository
git clone https://github.com/probelabs/memaris.git
cd memaris

# Install dependencies
bun install

# Run in development mode
bun run dev

# Build for production
bun run build

🔍 Troubleshooting

"No Claude Code projects found"

# Check if Claude Code history exists
ls ~/.claude/projects/

# If empty, use Claude Code first to create conversation history

"Project not detected"

# Use absolute path
npx -y @probelabs/memaris /full/path/to/your/project --debug

# Or use the scan command to see all detected projects
npx -y @probelabs/memaris scan

AI Analysis Not Working

# Verify API key is set
echo $ANTHROPIC_API_KEY

# Use pattern-only analysis as fallback
npx -y @probelabs/memaris --pattern-only --update

Performance Issues

# Reduce analysis scope
npx -y @probelabs/memaris --tokens 10000 --update

# Use smaller batch sizes
npx -y @probelabs/memaris --all --batch-size 25000 --update

🌐 Part of the Probe Ecosystem

Memaris is part of the Probe ecosystem—tools dedicated to improving human and AI collaboration in development.

• Probe - Code search that understands context
• Vow - Accountability gates for AI agents
• AFK - Remote control for Claude Code via Telegram

📄 License

MIT © Probe Labs

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📮 Support

Questions or feedback? Reach out at [e-mail]

Memaris: From the ancient Greek μνήμη (mneme) meaning memory - helping AI remember and learn from every conversation.