AI Repo Pulse
Keep AI context files (.cursorrules, CLAUDE.md, GEMINI.md, AGENTS.md) up-to-date with codebase changes — powered by MCP (Model Context Protocol).
Architecture
┌──────────────────────────────┐ stdio JSON-RPC
│ VS Code Extension │ ──────────────────────► │ MCP Server │
│ (orchestration + UX) │ ◄────────────────────── │ (pure logic)│
└──────────────────────────────┘ └─────────────┘
│ │
│ reads/writes │ GitHub REST API
▼ ▼
.ai-repo-pulse-state.json github.com/owner/repo
Two completely separate packages:
| Package |
Path |
Description |
ai-repo-pulse-mcp |
/mcp |
MCP server with 4 tools. No LLM. |
ai-repo-pulse |
/extension |
VS Code extension for UX + orchestration |
Installation & Setup
1. Install the MCP Server
Once published to the npm registry, the MCP server can be registered globally in your IDE's mcp_config.json configuration file:
"mcpServers": {
"ai-repo-pulse-mcp": {
"command": "npx",
"args": [
"-y",
"ai-repo-pulse-mcp"
]
}
}
2. Install the VS Code Extension
Install AI Repo Pulse directly from the VS Code Marketplace. It will automatically detect missing configuration files and keep track of repository updates.
| Tool |
Description |
check_context_files |
Checks for .cursorrules, CLAUDE.md, GEMINI.md, AGENTS.md |
scan_project |
Returns top-level project structure |
get_pr_updates |
Fetches new PRs from GitHub REST API |
summarize_changes |
Structured JSON summary of PR changes (no LLM) |
VS Code Commands
| Command |
Description |
AI Repo Pulse: Check Context Files |
Check for missing AI context files |
AI Repo Pulse: Check PR Updates |
Check for new PRs (shows alert if ≥ 5) |
AI Repo Pulse: Update Context |
Fetch PRs + summarize → open JSON for AI agent |
AI Repo Pulse: Set GitHub Repository |
Set your owner/repo |
AI Repo Pulse: Set GitHub Token |
Set a GitHub PAT (for private repos / higher rate limits) |
State File
A .ai-repo-pulse-state.json is created at your project root:
{
"lastProcessedPR": 42,
"threshold": 5
}
The threshold is hardcoded to 5 and cannot be changed.
Design Principles
- ✅ No
.git parsing — repo is provided by the user via InputBox
- ✅ No LLM calls — all tools return structured data for the IDE AI agent
- ✅ No automatic file modification — the extension never writes to user source files
- ✅ Strict separation — MCP and extension are completely independent packages
- ✅ Threshold = 5 — hardcoded, not user-configurable
