stellarion_mine_git_history [Pro]

Mines the project's git commit history to extract recurring patterns and create memories from them. Useful for bootstrapping knowledge on new or unfamiliar projects — learns which files change together, common fix patterns, frequently modified hotspots, and architectural conventions from past commits.

When to Use

• When onboarding to a new project to quickly learn its patterns
• To bootstrap Stellarion's memory layer for a project you have not worked on before
• To discover hidden conventions not documented anywhere
• To find change hotspots — files that are modified most frequently

Parameters

Examples

Bootstrap knowledge for a new project

Mine the git history of this project so you can learn its patterns.

Analyzes up to 500 recent commits and stores discovered patterns as memories.

Deep history analysis

Mine the last 1000 commits to find recurring patterns.

Sets maxCommits: 1000 for a deeper analysis.

High-confidence patterns only

Mine git history but only keep patterns you're very confident about — threshold 0.9.

Sets minConfidence: 0.9 to store only the most reliable patterns.

Output Format

Returns a summary of what was mined:

• Commits analyzed — how many commits were processed
• Patterns discovered — count of patterns extracted
• Pattern categories — types of patterns found:
  • Co-change patterns — files that frequently change together
  • Fix patterns — recurring bug fix patterns (e.g., "null check added to X")
  • Hotspots — files with the highest change frequency
  • Conventions — naming patterns, commit message conventions, common refactoring patterns
• Memories created — how many new memories were stored

Tips

• Run this once when you first start working on a project — the extracted patterns improve all subsequent queries
• Lower minConfidence to 0.5 for smaller repositories where patterns may not repeat often enough to reach high confidence
• Co-change patterns are particularly useful — they tell you "when you change file A, you probably also need to change file B"
• This tool does not modify your git history — it only reads it
• For file-specific history, use stellarion_mine_git_history_for_file instead
• Patterns are stored in Stellarion's memory layer and are used automatically by other tools