Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions sverklo/.cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
{
"name": "sverklo",
"displayName": "Sverklo Code Intelligence",
"version": "0.7.2",
"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.",
"author": {
"name": "Sverklo",
"email": "hello@sverklo.com"
},
"homepage": "https://sverklo.com",
"repository": "https://github.com/sverklo/sverklo",
"license": "MIT",
"logo": "assets/avatar.svg",
"keywords": [
"cursor-plugin",
"mcp",
"code-intelligence",
"code-search",
"semantic-search",
"impact-analysis",
"pagerank",
"memory",
"local-first"
],
"category": "developer-tools",
"tags": [
"code-search",
"code-review",
"refactoring",
"memory",
"mcp-server"
],
"skills": "./skills/",
"mcp": {
"sverklo": {
"command": "sverklo",
"args": ["."]
}
}
}
6 changes: 6 additions & 0 deletions sverklo/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Changelog

## 0.7.2 (2026-04-14)
- Initial Cursor marketplace plugin
- 22 MCP tools, 3 skills (onboard, review, refactor)
- Hybrid search, impact analysis, PR review, memory, clusters, wiki
21 changes: 21 additions & 0 deletions sverklo/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2026 Sverklo

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
25 changes: 25 additions & 0 deletions sverklo/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Sverklo Code Intelligence

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.

## What you get

- **22 MCP tools** — semantic search, symbol lookup, blast-radius analysis, PR review, memory, clusters, wiki
- **3 skills** — onboard to a codebase, review changes, plan safe refactors
- **Hybrid search** — BM25 + ONNX embeddings + PageRank via Reciprocal Rank Fusion
- **Persistent memory** — decisions survive across sessions, tied to git state
- **100% local** — no API keys, no cloud, MIT licensed

## Install

```bash
npm install -g sverklo
```

The plugin auto-configures the MCP server. After install, Cursor's agent has access to all 22 sverklo tools.

## Links

- [Website](https://sverklo.com)
- [GitHub](https://github.com/sverklo/sverklo)
- [Benchmarks](https://sverklo.com/benchmarks)
7 changes: 7 additions & 0 deletions sverklo/assets/avatar.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
20 changes: 20 additions & 0 deletions sverklo/skills/onboard.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
name: Onboard to Codebase
description: Build a mental model of this codebase using sverklo's overview, top-PageRank files, and core memories.
arguments:
- name: focus
description: Optional area to focus on (e.g. 'auth', 'billing')
required: false
---

Help a new developer get oriented in this codebase.

1. Call `sverklo_overview` to get the high-level structure: top languages, top-PageRank files, module map.
2. Call `sverklo_recall query:"architecture"` and `sverklo_recall query:"conventions"` to surface any saved invariants.
3. Pick 2-3 of the highest-PageRank source files and call `sverklo_lookup` on their main exported symbols.
4. For the most central file, call `sverklo_deps` to show its place in the import graph.

Write a concise onboarding doc (under 600 words) with:
- "Start here" — the 3-5 files to read first
- "Key abstractions" — the named concepts a new dev needs
- "Conventions" — anything from recall that affects how to write code
21 changes: 21 additions & 0 deletions sverklo/skills/refactor.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
name: Plan Safe Refactor
description: Analyze blast radius and plan a safe refactor using impact analysis, references, and test mapping.
arguments:
- name: symbol
description: The symbol to refactor (function, class, or type name)
required: true
---

Plan a safe refactor for the symbol `{{symbol}}`:

1. Call `sverklo_impact symbol:"{{symbol}}"` to see all callers and the blast radius.
2. Call `sverklo_refs symbol:"{{symbol}}"` to find every reference with exact matching.
3. Call `sverklo_deps` on the file to understand dependency context.
4. Call `sverklo_test_map` to identify which tests need updating.

Present:
- Full list of files that need changes
- Risk level for each
- Step-by-step refactor plan
- Tests to update or add
20 changes: 20 additions & 0 deletions sverklo/skills/review.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
name: Review Changes
description: Diff-aware code review with risk scoring, blast radius, and test coverage analysis.
arguments:
- name: ref
description: Git ref or range to review (default main..HEAD)
required: false
---

Review the current diff using sverklo's diff-aware tools:

1. Call `sverklo_review_diff` to get changed files, risk scores, dangling references, and structural warnings.
2. Call `sverklo_test_map` to see which tests cover the changes and which files are untested.
3. For any removed symbol with dangling references, call `sverklo_impact` to see every caller.
4. For any high-risk file, read the actual diff to verify the risk assessment.

Synthesize a review with:
- Clear verdict (LGTM / request changes / blocking concern)
- Must-fix items tied to file:line
- Untested changes that need coverage