From 4b59b73a97f6d9d1b864baccd96a66b8cc0828db Mon Sep 17 00:00:00 2001 From: nike-17 <676670+nike-17@users.noreply.github.com> Date: Wed, 15 Apr 2026 10:07:47 -0700 Subject: [PATCH] Add Sverklo code intelligence plugin --- sverklo/.cursor-plugin/plugin.json | 40 ++++++++++++++++++++++++++++++ sverklo/CHANGELOG.md | 6 +++++ sverklo/LICENSE | 21 ++++++++++++++++ sverklo/README.md | 25 +++++++++++++++++++ sverklo/assets/avatar.svg | 7 ++++++ sverklo/skills/onboard.md | 20 +++++++++++++++ sverklo/skills/refactor.md | 21 ++++++++++++++++ sverklo/skills/review.md | 20 +++++++++++++++ 8 files changed, 160 insertions(+) create mode 100644 sverklo/.cursor-plugin/plugin.json create mode 100644 sverklo/CHANGELOG.md create mode 100644 sverklo/LICENSE create mode 100644 sverklo/README.md create mode 100644 sverklo/assets/avatar.svg create mode 100644 sverklo/skills/onboard.md create mode 100644 sverklo/skills/refactor.md create mode 100644 sverklo/skills/review.md diff --git a/sverklo/.cursor-plugin/plugin.json b/sverklo/.cursor-plugin/plugin.json new file mode 100644 index 0000000..a20a9e0 --- /dev/null +++ b/sverklo/.cursor-plugin/plugin.json @@ -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": ["."] + } + } +} diff --git a/sverklo/CHANGELOG.md b/sverklo/CHANGELOG.md new file mode 100644 index 0000000..509d26a --- /dev/null +++ b/sverklo/CHANGELOG.md @@ -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 diff --git a/sverklo/LICENSE b/sverklo/LICENSE new file mode 100644 index 0000000..17d2937 --- /dev/null +++ b/sverklo/LICENSE @@ -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. diff --git a/sverklo/README.md b/sverklo/README.md new file mode 100644 index 0000000..45dfd54 --- /dev/null +++ b/sverklo/README.md @@ -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) diff --git a/sverklo/assets/avatar.svg b/sverklo/assets/avatar.svg new file mode 100644 index 0000000..dee3aa2 --- /dev/null +++ b/sverklo/assets/avatar.svg @@ -0,0 +1,7 @@ + + + + sv + + sverklo + diff --git a/sverklo/skills/onboard.md b/sverklo/skills/onboard.md new file mode 100644 index 0000000..2ab54e6 --- /dev/null +++ b/sverklo/skills/onboard.md @@ -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 diff --git a/sverklo/skills/refactor.md b/sverklo/skills/refactor.md new file mode 100644 index 0000000..1869736 --- /dev/null +++ b/sverklo/skills/refactor.md @@ -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 diff --git a/sverklo/skills/review.md b/sverklo/skills/review.md new file mode 100644 index 0000000..1524035 --- /dev/null +++ b/sverklo/skills/review.md @@ -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