bootspring_memory
Access git-based project memory. Extract learnings, search history, and get file-specific context.
Overview
The bootspring_memory tool provides access to your project's git history as a knowledge base. It extracts learnings from commit messages, categorizes them, and makes them searchable. This helps your AI assistant understand past decisions and patterns.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | Yes | Action to perform |
query | string | No | Search query (for search action) |
files | array | No | File paths to get learnings for (for files action) |
limit | number | No | Max learnings to return (default: 20) |
Actions
| Action | Description |
|---|---|
summary | Get categorized learnings summary |
search | Search learnings by keyword |
files | Get learnings for specific files |
stats | Get repository overview statistics |
Usage Examples
Get Summary
Use the bootspring_memory tool with:
- action: "summary"
- limit: 30
Response:
Search Learnings
Use the bootspring_memory tool with:
- action: "search"
- query: "authentication"
- limit: 10
Response:
Get File-Specific Learnings
Use the bootspring_memory tool with:
- action: "files"
- files: ["src/lib/auth.ts", "src/middleware.ts"]
- limit: 15
Response:
Get Repository Stats
Use the bootspring_memory tool with:
- action: "stats"
Response:
Memory Categories
Learnings are automatically categorized based on commit prefixes:
| Category | Prefix | Icon | Description |
|---|---|---|---|
feature | feat: | F | New features |
bug_fix | fix: | B | Bug fixes |
refactor | refactor: | R | Code refactoring |
documentation | docs: | D | Documentation changes |
test | test: | T | Test additions/changes |
chore | chore: | C | Maintenance tasks |
performance | perf: | P | Performance improvements |
security | security: | S | Security fixes |
Error Handling
Not a Git Repository
Missing Query
Missing Files
Use Cases
Understanding Past Decisions
Before making changes to a file:
Use bootspring_memory with:
- action: "files"
- files: ["src/components/Dashboard.tsx"]
This shows why the component was changed in the past.
Finding Similar Solutions
When encountering a problem:
Use bootspring_memory with:
- action: "search"
- query: "timeout error"
Find how similar issues were resolved before.
Onboarding Context
For new team members:
Use bootspring_memory with:
- action: "summary"
Get an overview of project history and patterns.
Best Practices
Write Good Commit Messages
Memory quality depends on commit message quality. Use conventional commits:
feat: add user authenticationfix: resolve database connection timeoutrefactor: extract validation logic
Regular Commits
More frequent, focused commits create better memory entries.
Include Context in Commits
Add details in commit body for richer memory:
feat: add rate limiting to API
- Implemented sliding window algorithm
- 100 requests per minute per user
- Returns 429 with Retry-After header
Related
- Memory Feature Guide - Persistent cross-session memory agent (hook-based)
- bootspring_context - Generate project context
- bootspring memory CLI - CLI memory commands