bootspring_memory | Bootspring Docs

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:

{
  "totalLearnings": 45,
  "categories": {
    "bug_fix": {
      "icon": "B",
      "label": "Bug Fixes",
      "count": 12,
      "top": [
        { "hash": "abc123", "summary": "fix: resolve auth token expiration" },
        { "hash": "def456", "summary": "fix: handle null user in dashboard" },
        { "hash": "ghi789", "summary": "fix: correct date formatting in reports" }
      ]
    },
    "feature": {
      "icon": "F",
      "label": "Features",
      "count": 18,
      "top": [
        { "hash": "jkl012", "summary": "feat: add user profile page" },
        { "hash": "mno345", "summary": "feat: implement email notifications" },
        { "hash": "pqr678", "summary": "feat: add dark mode support" }
      ]
    },
    "refactor": {
      "icon": "R",
      "label": "Refactoring",
      "count": 8,
      "top": [
        { "hash": "stu901", "summary": "refactor: extract auth logic to hook" },
        { "hash": "vwx234", "summary": "refactor: simplify API error handling" }
      ]
    },
    "documentation": {
      "icon": "D",
      "label": "Documentation",
      "count": 7,
      "top": [
        { "hash": "yza567", "summary": "docs: add API reference" }
      ]
    }
  }
}

Search Learnings#

Use the bootspring_memory tool with:
- action: "search"
- query: "authentication"
- limit: 10

Response:

{
  "query": "authentication",
  "matches": [
    {
      "hash": "abc123",
      "summary": "feat: implement Clerk authentication",
      "categories": ["feature", "security"],
      "details": "Added Clerk provider, middleware, and protected routes..."
    },
    {
      "hash": "def456",
      "summary": "fix: resolve auth token expiration issue",
      "categories": ["bug_fix", "security"],
      "details": "Tokens were expiring prematurely due to timezone..."
    },
    {
      "hash": "ghi789",
      "summary": "refactor: centralize authentication logic",
      "categories": ["refactor"],
      "details": "Moved auth helpers to lib/auth.ts..."
    }
  ]
}

Get File-Specific Learnings#

Use the bootspring_memory tool with:
- action: "files"
- files: ["src/lib/auth.ts", "src/middleware.ts"]
- limit: 15

Response:

{
  "files": ["src/lib/auth.ts", "src/middleware.ts"],
  "learnings": [
    {
      "hash": "abc123",
      "file": "src/lib/auth.ts",
      "summary": "feat: add session validation helper",
      "categories": ["feature"]
    },
    {
      "hash": "def456",
      "file": "src/middleware.ts",
      "summary": "fix: handle unauthenticated API requests",
      "categories": ["bug_fix"]
    },
    {
      "hash": "ghi789",
      "file": "src/lib/auth.ts",
      "summary": "refactor: use Clerk's built-in helpers",
      "categories": ["refactor"]
    }
  ]
}

Get Repository Stats#

Use the bootspring_memory tool with:
- action: "stats"

Response:

{
  "totalCommits": 245,
  "contributors": 3,
  "firstCommit": "2024-01-15",
  "lastCommit": "2024-03-20",
  "categoryCounts": {
    "feature": 89,
    "bug_fix": 56,
    "refactor": 42,
    "documentation": 28,
    "test": 18,
    "chore": 12
  }
}

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#

{
  "error": "Not a git repository",
  "hint": "Initialize git with: git init"
}

Missing Query#

{
  "error": "query required for search"
}

Missing Files#

{
  "error": "files array required"
}

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 authentication
fix: resolve database connection timeout
refactor: 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

bootspring_context - Generate project context
bootspring_assist - Uses memory for recommendations
bootspring_workflow - Memory informs workflow suggestions