Skip to content

Commit 4b59b73

Browse files
committed
Add Sverklo code intelligence plugin
1 parent a0cd104 commit 4b59b73

8 files changed

Lines changed: 160 additions & 0 deletions

File tree

sverklo/.cursor-plugin/plugin.json

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
{
2+
"name": "sverklo",
3+
"displayName": "Sverklo Code Intelligence",
4+
"version": "0.7.2",
5+
"description": "Local-first code intelligence MCP — hybrid search, impact analysis, diff-aware PR review, persistent memory, cluster detection, and wiki generation. 22 tools, MIT licensed.",
6+
"author": {
7+
"name": "Sverklo",
8+
"email": "hello@sverklo.com"
9+
},
10+
"homepage": "https://sverklo.com",
11+
"repository": "https://github.com/sverklo/sverklo",
12+
"license": "MIT",
13+
"logo": "assets/avatar.svg",
14+
"keywords": [
15+
"cursor-plugin",
16+
"mcp",
17+
"code-intelligence",
18+
"code-search",
19+
"semantic-search",
20+
"impact-analysis",
21+
"pagerank",
22+
"memory",
23+
"local-first"
24+
],
25+
"category": "developer-tools",
26+
"tags": [
27+
"code-search",
28+
"code-review",
29+
"refactoring",
30+
"memory",
31+
"mcp-server"
32+
],
33+
"skills": "./skills/",
34+
"mcp": {
35+
"sverklo": {
36+
"command": "sverklo",
37+
"args": ["."]
38+
}
39+
}
40+
}

sverklo/CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# Changelog
2+
3+
## 0.7.2 (2026-04-14)
4+
- Initial Cursor marketplace plugin
5+
- 22 MCP tools, 3 skills (onboard, review, refactor)
6+
- Hybrid search, impact analysis, PR review, memory, clusters, wiki

sverklo/LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Sverklo
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

sverklo/README.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Sverklo Code Intelligence
2+
3+
Local-first code intelligence MCP server for Cursor. Hybrid search, impact analysis, diff-aware PR review, persistent memory, and more — running entirely on your machine.
4+
5+
## What you get
6+
7+
- **22 MCP tools** — semantic search, symbol lookup, blast-radius analysis, PR review, memory, clusters, wiki
8+
- **3 skills** — onboard to a codebase, review changes, plan safe refactors
9+
- **Hybrid search** — BM25 + ONNX embeddings + PageRank via Reciprocal Rank Fusion
10+
- **Persistent memory** — decisions survive across sessions, tied to git state
11+
- **100% local** — no API keys, no cloud, MIT licensed
12+
13+
## Install
14+
15+
```bash
16+
npm install -g sverklo
17+
```
18+
19+
The plugin auto-configures the MCP server. After install, Cursor's agent has access to all 22 sverklo tools.
20+
21+
## Links
22+
23+
- [Website](https://sverklo.com)
24+
- [GitHub](https://github.com/sverklo/sverklo)
25+
- [Benchmarks](https://sverklo.com/benchmarks)

sverklo/assets/avatar.svg

Lines changed: 7 additions & 0 deletions
Loading

sverklo/skills/onboard.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
name: Onboard to Codebase
3+
description: Build a mental model of this codebase using sverklo's overview, top-PageRank files, and core memories.
4+
arguments:
5+
- name: focus
6+
description: Optional area to focus on (e.g. 'auth', 'billing')
7+
required: false
8+
---
9+
10+
Help a new developer get oriented in this codebase.
11+
12+
1. Call `sverklo_overview` to get the high-level structure: top languages, top-PageRank files, module map.
13+
2. Call `sverklo_recall query:"architecture"` and `sverklo_recall query:"conventions"` to surface any saved invariants.
14+
3. Pick 2-3 of the highest-PageRank source files and call `sverklo_lookup` on their main exported symbols.
15+
4. For the most central file, call `sverklo_deps` to show its place in the import graph.
16+
17+
Write a concise onboarding doc (under 600 words) with:
18+
- "Start here" — the 3-5 files to read first
19+
- "Key abstractions" — the named concepts a new dev needs
20+
- "Conventions" — anything from recall that affects how to write code

sverklo/skills/refactor.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
name: Plan Safe Refactor
3+
description: Analyze blast radius and plan a safe refactor using impact analysis, references, and test mapping.
4+
arguments:
5+
- name: symbol
6+
description: The symbol to refactor (function, class, or type name)
7+
required: true
8+
---
9+
10+
Plan a safe refactor for the symbol `{{symbol}}`:
11+
12+
1. Call `sverklo_impact symbol:"{{symbol}}"` to see all callers and the blast radius.
13+
2. Call `sverklo_refs symbol:"{{symbol}}"` to find every reference with exact matching.
14+
3. Call `sverklo_deps` on the file to understand dependency context.
15+
4. Call `sverklo_test_map` to identify which tests need updating.
16+
17+
Present:
18+
- Full list of files that need changes
19+
- Risk level for each
20+
- Step-by-step refactor plan
21+
- Tests to update or add

sverklo/skills/review.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
name: Review Changes
3+
description: Diff-aware code review with risk scoring, blast radius, and test coverage analysis.
4+
arguments:
5+
- name: ref
6+
description: Git ref or range to review (default main..HEAD)
7+
required: false
8+
---
9+
10+
Review the current diff using sverklo's diff-aware tools:
11+
12+
1. Call `sverklo_review_diff` to get changed files, risk scores, dangling references, and structural warnings.
13+
2. Call `sverklo_test_map` to see which tests cover the changes and which files are untested.
14+
3. For any removed symbol with dangling references, call `sverklo_impact` to see every caller.
15+
4. For any high-risk file, read the actual diff to verify the risk assessment.
16+
17+
Synthesize a review with:
18+
- Clear verdict (LGTM / request changes / blocking concern)
19+
- Must-fix items tied to file:line
20+
- Untested changes that need coverage

0 commit comments

Comments
 (0)