Skip to content

lledellebell/glean

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 | 日本語 | 한국어 | Français | Deutsch

License: MIT GitHub Package GitHub Release GitHub stars GitHub forks GitHub issues GitHub last commit GitHub code size GitHub contributors CI Node.js DeepWiki

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 9 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
Backfill Extractor Historical session analysis
Dedup Validator Result deduplication

Spaced Repetition

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

Confidence Next Review
5/5 30 days
4/5 14 days
3/5 7 days
2/5 3 days
1/5 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

Claude Code Plugin Marketplace (Recommended)

Glean

claude plugin install glean-core@glean

npm

npm install @lledellebell/glean --registry=https://npm.pkg.github.com

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. Run setup wizard
npx @lledellebell/glean init

# 2. Start a coding session with Claude Code
claude

# 3. Do your work...

# 4. Harvest knowledge at session end
/glean

# 5. Review your learnings later
/learn review

CLI

# Setup wizard - configure Glean interactively
npx @lledellebell/glean init

# Check current configuration
npx @lledellebell/glean status

# Show help
npx @lledellebell/glean help

Commands

Core Commands

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

/glean-backfill             # Backfill from past sessions (current project)
/glean-backfill --all       # Backfill all projects
/glean-backfill --dry-run   # Preview without storing

/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

# 83 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!

About

Harvest knowledge from AI coding sessions - Claude Code plugin with spaced repetition learning

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors