Glean 🌾

Never forget what you learn from AI coding sessions

Glean automatically harvests knowledge from your Claude Code sessions and transforms it into long-term memory using spaced repetition.

Español | 日本語

The Problem

When AI coding sessions end, valuable information disappears:

• 💡 Code patterns and conventions you discovered
• ⚠️ Mistakes you made and how you fixed them
• 📚 Concepts you learnt (forgotten by next week)
• 🔧 Useful commands and workflows

Glean captures all of this automatically and helps you retain it permanently.

Features

🌾 Session Harvesting

Analyse your coding session with 8 specialised AI agents running in parallel:

| Agent | Purpose | |-------|---------| | Session Analyzer | Core harvest data generation | | Doc Analyzer | Documentation update suggestions | | Automation Finder | Automation opportunity detection | | Learning Extractor | Learning point extraction | | Followup Planner | Next task planning | | Pattern Recognizer | Code pattern detection | | Mistake Analyzer | Error/mistake analysis | | Dedup Validator | Result deduplication |

🧠 Spaced Repetition

Built-in SM-2 algorithm schedules reviews at optimal intervals:

| Confidence | Next Review | |------------|-------------| | ⭐⭐⭐⭐⭐ | 30 days | | ⭐⭐⭐⭐ | 14 days | | ⭐⭐⭐ | 7 days | | ⭐⭐ | 3 days | | ⭐ | 1 day |

🔌 Plugin Ecosystem

12 feature plugins for comprehensive session management:

| Plugin | Description | |--------|-------------| | /harvest | Session knowledge harvesting | | /insight | Pattern and insight extraction | | /learn | Spaced repetition learning | | /memory | Persistent memory (remember/recall) | | /context | Session context save/restore | | /plan | Task planning and tracking | | /pr | Pull request workflow automation | | /review | Code review helper | | /history | Session history search | | /sync | External tool synchronisation | | /notify | Notification management | | /stats | Session statistics |

🌉 Bridge Integrations

Connect with external tools:

• Obsidian - Export insights to your vault
• GitHub - Create issues from tasks
• Notion - Sync learnings to databases

Installation

Manual Installation

# Clone to your plugins directory
git clone https://github.com/lledellebell/glean.git ~/.claude/plugins/glean

# Or clone anywhere and reference in settings
git clone https://github.com/lledellebell/glean.git ~/glean

Configuration

Add to your Claude Code settings:

{
  "commandPaths": ["~/glean/commands", "~/glean/plugins/*/commands"]
}

Quick Start

# 1. Start a coding session with Claude Code
claude

# 2. Do your work...

# 3. Harvest knowledge at session end
/glean

# 4. Review your learnings later
/learn review

Commands

Core Commands

/glean              # Harvest current session (parallel agents)
/glean --verbose    # Detailed output with all agent results

/harvest            # Quick knowledge harvest
/harvest --full     # Comprehensive analysis

/insight            # Extract insights
/insight --type pattern   # Only patterns
/insight --type mistake   # Only mistakes

Learning Commands

/learn add "React Query caches by query key"  # Add learning
/learn list                                    # View learnings
/learn review                                  # Start review session
/learn quiz --topic react                      # Quiz mode

Memory Commands

/remember "API uses camelCase for responses"  # Save to memory
/recall api                                    # Search memory

Workflow Commands

/plan create "Auth system"    # Create development plan
/plan add "Add login form"    # Add task
/plan done 1                  # Mark complete

/pr create                    # Create pull request
/review src/                  # Code review

Data Storage

~/.glean/
├── harvests/     # Session harvest data (JSON)
├── insights/     # Extracted insights
├── learn/        # Learning items with review schedule
├── contexts/     # Saved session contexts
├── history/      # Session history
└── config.json   # Configuration

Configuration

Create ~/.glean/config.json:

{
  "harvest": {
    "autoHarvest": true,
    "mode": "quick",
    "minDuration": 600
  },
  "learn": {
    "reviewReminder": true,
    "defaultConfidence": 3
  },
  "integrations": {
    "obsidian": {
      "enabled": true,
      "vaultPath": "~/Documents/Obsidian/Vault"
    }
  }
}

Testing

# Run all tests
npm test

# 61 tests covering:
# - Spaced repetition algorithm
# - Data transformers
# - Plugin detection

Contributing

We welcome contributions! See CONTRIBUTING.md for:

• Development setup
• Code guidelines
• Testing requirements
• Pull request process

Roadmap

• [ ] Web dashboard for review
• [ ] Team knowledge sharing
• [ ] More integrations (Linear, Jira)
• [ ] AI-powered review suggestions

Licence

MIT Licence - See LICENSE

Author

lledellebell - GitHub

"Remember today what you learnt yesterday" 🧠

Star ⭐ this repo if Glean helps you learn!