{"id":43773682,"url":"https://github.com/adverant/nexus-cursor-plugin","last_synced_at":"2026-02-05T17:06:05.191Z","repository":{"id":327569301,"uuid":"1108298566","full_name":"adverant/nexus-cursor-plugin","owner":"adverant","description":"Adverant-Powered GraphRAG Plugin for Cursor IDE - Knowledge Graph-based code intelligence with episodic memory, impact analysis, and multi-agent orchestration","archived":false,"fork":false,"pushed_at":"2025-12-04T13:46:49.000Z","size":204,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-07T18:46:39.701Z","etag":null,"topics":["ai","curosr","git","gitblame","graprag"],"latest_commit_sha":null,"homepage":"https://adverant.ai/open-source","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adverant.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-02T09:31:25.000Z","updated_at":"2025-12-04T13:46:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/adverant/nexus-cursor-plugin","commit_stats":null,"previous_names":["adverant/nexus-cursor-plugin"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/adverant/nexus-cursor-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adverant%2Fnexus-cursor-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adverant%2Fnexus-cursor-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adverant%2Fnexus-cursor-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adverant%2Fnexus-cursor-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adverant","download_url":"https://codeload.github.com/adverant/nexus-cursor-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adverant%2Fnexus-cursor-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29126118,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T14:05:12.718Z","status":"ssl_error","status_checked_at":"2026-02-05T14:03:53.078Z","response_time":65,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","curosr","git","gitblame","graprag"],"created_at":"2026-02-05T17:06:04.213Z","updated_at":"2026-02-05T17:06:05.185Z","avatar_url":"https://github.com/adverant.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"docs/images/adverant-logo-final.svg\" alt=\"Adverant Logo\" width=\"240\"/\u003e\n\n  # Nexus Cursor Plugin\n\n  **GraphRAG-Powered Code Intelligence for Cursor IDE**\n\n  [![npm version](https://img.shields.io/npm/v/@adverant/nexus-cursor-plugin)](https://www.npmjs.com/package/@adverant/nexus-cursor-plugin)\n  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n  [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)\n  [![Tests](https://img.shields.io/badge/Tests-185%20passing-brightgreen)](.)\n  [![MCP](https://img.shields.io/badge/MCP-1.0-purple)](https://modelcontextprotocol.io/)\n\n  **Version:** 0.2.0 | **Last Updated:** December 4, 2025\n\n  [Why Nexus?](#why-nexus) • [NexusMind](#-nexusmind-visualization) • [Features](#features) • [Quick Start](#quick-start) • [Pricing](#pricing)\n\u003c/div\u003e\n\n---\n\n## Why Nexus?\n\nMost tools tell you **who** changed code. Nexus tells you **why**.\n\n| Traditional Tools | Nexus Cursor Plugin |\n|-------------------|---------------------|\n| Shows git blame (who, when) | Connects changes to **intent** via knowledge graph |\n| File history as a timeline | **Episodic memory** — understands evolution patterns |\n| Search by filename/text | **Semantic search** — understands what code *does* |\n| No prediction | **Impact analysis** — see ripple effects *before* you change |\n| Static diagrams | **NexusMind** — interactive, AI-powered code visualization |\n\n### The Knowledge Gap Problem\n\nEvery codebase has tribal knowledge trapped in developers' heads:\n- *\"Don't touch that file, it breaks everything\"*\n- *\"We tried that approach in 2022, here's why it failed\"*\n- *\"This workaround exists because of X edge case\"*\n\n**Nexus captures this.** Every query, every explanation, every impact analysis builds your codebase's institutional memory. New team members get context that would take months to acquire.\n\n---\n\n## 🧠 NexusMind Visualization\n\n\u003e **NEW in v0.2.0** — Transform your codebase into an explorable knowledge graph\n\nNexusMind is an interactive, AI-driven code visualization system that goes beyond traditional diagrams. It leverages GraphRAG infrastructure, multi-model AI orchestration, and temporal code analysis to create living, breathing visualizations.\n\n### Architecture Overview\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│                           Cursor IDE                                     │\n├─────────────────────────────────────────────────────────────────────────┤\n│   ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────────┐  │\n│   │  NexusMind Panel │  │   Graph Viewer   │  │   Minimap Overlay    │  │\n│   │  (Interactive)   │  │  (Force Layout)  │  │  (Navigation)        │  │\n│   └────────┬─────────┘  └────────┬─────────┘  └──────────┬───────────┘  │\n│            └─────────────────────┼───────────────────────┘              │\n│                                  │                                      │\n│                      ┌───────────▼───────────┐                          │\n│                      │    MCP Tool Layer     │                          │\n│                      │  (nexusmind_* tools)  │                          │\n│                      └───────────┬───────────┘                          │\n└──────────────────────────────────┼──────────────────────────────────────┘\n                                   │\n          ┌────────────────────────┼────────────────────────┐\n          │                        │                        │\n┌─────────▼─────────┐  ┌───────────▼───────────┐  ┌────────▼────────┐\n│   GraphRAG API    │  │    MageAgent API      │  │   Git Service   │\n│  (Knowledge Graph)│  │  (Multi-Model AI)     │  │   (Temporal)    │\n│                   │  │                       │  │                 │\n│ • Entity Storage  │  │ • Orchestration       │  │ • File History  │\n│ • Vector Search   │  │ • Competition Mode    │  │ • Blame Data    │\n│ • Relationships   │  │ • Collaboration Mode  │  │ • Diff Analysis │\n└───────────────────┘  └───────────────────────┘  └─────────────────┘\n```\n\n### NexusMind Tools\n\n| Tool | Description | Use Case |\n|------|-------------|----------|\n| `nexusmind_dependency_graph` | Interactive dependency visualization | Understand code structure |\n| `nexusmind_evolution_timeline` | Code history over time | Track how code evolved |\n| `nexusmind_impact_ripple` | Change propagation visualization | Pre-change risk assessment |\n| `nexusmind_semantic_clusters` | AI-powered code grouping | Find related code |\n| `nexusmind_architecture_analyze` | Code smell detection | Improve architecture |\n| `nexusmind_nl_query` | Natural language graph queries | Explore visually |\n\n---\n\n### 📊 Dependency Graph\n\nBuild interactive dependency graphs with multiple layout algorithms.\n\n```\n@nexus nexusmind_dependency_graph rootFile=\"src/server.ts\" depth=3\n```\n\n**Layout Options:**\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│                                                                         │\n│   FORCE-DIRECTED              HIERARCHICAL            RADIAL            │\n│                                                                         │\n│       ○───○                      ○                       ○              │\n│      /│   │\\                    /│\\                    / │ \\            │\n│     ○ │   │ ○                  ○ ○ ○                  ○  ○  ○           │\n│      \\│   │/                  /│   │\\                 │  │  │           │\n│       ○───○                  ○ ○   ○ ○               ○  ○  ○            │\n│                                                                         │\n│   Best for:                Best for:             Best for:              │\n│   Complex dependencies     Module hierarchy      Central modules        │\n│                                                                         │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\n**Features:**\n- **Node Types**: Files, functions, classes, modules\n- **Edge Types**: Imports, calls, extends, implements\n- **Metrics per Node**: Complexity, change frequency, impact score\n- **Filtering**: Include/exclude test files, external deps\n\n**Example Output:**\n\n```\n┌──────────────────────────────────────────────────────────────┐\n│                    server.ts                                  │\n│                    [complexity: 15]                           │\n│                         │                                     │\n│          ┌──────────────┼──────────────┐                      │\n│          │              │              │                      │\n│          ▼              ▼              ▼                      │\n│    ┌──────────┐  ┌──────────┐  ┌──────────────┐              │\n│    │ graphrag │  │ mageagent│  │ visualization│              │\n│    │ -client  │  │ -client  │  │   -handler   │              │\n│    │ [12]     │  │ [8]      │  │ [22]         │              │\n│    └────┬─────┘  └────┬─────┘  └───────┬──────┘              │\n│         │             │                │                      │\n│         ▼             ▼                ▼                      │\n│    ┌─────────┐  ┌─────────┐  ┌─────────────────┐             │\n│    │  axios  │  │  axios  │  │ dependency-graph│             │\n│    │[external]│ │[external]│ │ evolution-timeline│            │\n│    └─────────┘  └─────────┘  │ impact-ripple    │             │\n│                              │ semantic-clusters│             │\n│                              └─────────────────┘             │\n└──────────────────────────────────────────────────────────────┘\n```\n\n---\n\n### 📈 Evolution Timeline\n\nVisualize how code entities evolve over time with AI-generated insights.\n\n```\n@nexus nexusmind_evolution_timeline entity=\"src/server.ts\" granularity=\"week\"\n```\n\n**Timeline Visualization:**\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│                        server.ts Evolution                               │\n├─────────────────────────────────────────────────────────────────────────┤\n│                                                                         │\n│  Commits  ████░░██████░░░░████████░░░░░░██████████████████░░░░████      │\n│           Oct       Nov       Dec       Jan       Feb       Mar         │\n│                                                                         │\n│  ─────────────────────────────────────────────────────────────────────  │\n│                                                                         │\n│  Oct 15   ● Initial server implementation                               │\n│           │ Author: alice@team.com                                      │\n│           │ +245 lines, -0 lines                                        │\n│           │                                                             │\n│  Nov 3    ● Added authentication middleware                             │\n│           │ Author: bob@team.com                                        │\n│           │ +89 lines, -12 lines                                        │\n│           │ Impact: HIGH - 8 dependent files                            │\n│           │                                                             │\n│  Dec 20   ● Refactored to use dependency injection                      │\n│           │ Author: alice@team.com                                      │\n│           │ +156 lines, -98 lines                                       │\n│           │ AI Summary: \"Major architectural change enabling            │\n│           │              better testability and modularity\"             │\n│           │                                                             │\n│  Feb 1    ● Added NexusMind visualization support                       │\n│           │ Author: claude@anthropic.com                                │\n│           │ +162 lines, -2 lines                                        │\n│                                                                         │\n├─────────────────────────────────────────────────────────────────────────┤\n│  STATISTICS                                                             │\n│  • Total Commits: 47          • Most Active: alice (28 commits)         │\n│  • Lines Changed: +1,234 -567 • Churn Rate: 2.3 changes/week            │\n│  • Contributors: 5            • Avg Complexity: Growing (+15%)          │\n├─────────────────────────────────────────────────────────────────────────┤\n│  AI INSIGHTS                                                            │\n│  • \"High change frequency suggests active development area\"             │\n│  • \"Consider adding comprehensive tests before next refactor\"           │\n│  • \"Authentication changes had broad impact - document API contract\"    │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n### 🎯 Impact Ripple\n\nVisualize how changes propagate through your codebase with severity-coded concentric rings.\n\n```\n@nexus nexusmind_impact_ripple entityId=\"UserService\" maxDepth=3\n```\n\n**Ripple Visualization:**\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│                                                                         │\n│                         Impact Ripple: UserService                      │\n│                                                                         │\n│                              ┌─────────┐                                │\n│                              │  USER   │                                │\n│                              │ SERVICE │  ← Selected Entity             │\n│                              └────┬────┘                                │\n│                                   │                                     │\n│            ┌──────────────────────┼──────────────────────┐              │\n│            │                      │                      │              │\n│      ┌─────▼─────┐          ┌─────▼─────┐          ┌─────▼─────┐        │\n│      │   AUTH    │          │  PROFILE  │          │   TEAM    │        │\n│      │  SERVICE  │          │  SERVICE  │          │  SERVICE  │        │\n│      │  ■■■■■■   │          │  ■■■■░░   │          │  ■■░░░░   │        │\n│      │  CRITICAL │          │   HIGH    │          │  MEDIUM   │        │\n│      └─────┬─────┘          └─────┬─────┘          └─────┬─────┘        │\n│            │                      │                      │              │\n│     ┌──────┼──────┐        ┌──────┼──────┐        ┌──────┼──────┐       │\n│     │      │      │        │      │      │        │      │      │       │\n│   ┌─▼─┐  ┌─▼─┐  ┌─▼─┐    ┌─▼─┐  ┌─▼─┐  ┌─▼─┐    ┌─▼─┐  ┌─▼─┐  ┌─▼─┐    │\n│   │API│  │JWT│  │2FA│    │IMG│  │BIO│  │SET│    │INV│  │ROL│  │PRM│    │\n│   │ ■ │  │ ■ │  │ ░ │    │ ░ │  │ ░ │  │ ░ │    │ ░ │  │ ░ │  │ ░ │    │\n│   └───┘  └───┘  └───┘    └───┘  └───┘  └───┘    └───┘  └───┘  └───┘    │\n│                                                                         │\n│   LEGEND:  ■ = Critical   ■ = High   ░ = Medium   ░ = Low               │\n│                                                                         │\n├─────────────────────────────────────────────────────────────────────────┤\n│  IMPACT SUMMARY                                                         │\n│  • Critical Impact: 3 files (direct dependencies)                       │\n│  • High Impact: 5 files (1 hop away)                                    │\n│  • Medium Impact: 12 files (2 hops away)                                │\n│  • Test Files Affected: 8                                               │\n│  • Recommended: Review AuthService and ProfileService before changes    │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n### 🔮 Semantic Clusters\n\nGroup code by semantic similarity using AI-powered clustering algorithms.\n\n```\n@nexus nexusmind_semantic_clusters algorithm=\"kmeans\" numClusters=5\n```\n\n**Clustering Visualization:**\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│                     Semantic Code Clusters                               │\n├─────────────────────────────────────────────────────────────────────────┤\n│                                                                         │\n│   ┌─────────────────────────────────────────────────────────────────┐   │\n│   │                                                                 │   │\n│   │    ┌───────────────┐         ┌───────────────┐                  │   │\n│   │    │  CLUSTER 1    │         │  CLUSTER 2    │                  │   │\n│   │    │  \"Auth \u0026      │         │  \"Data        │                  │   │\n│   │    │   Security\"   │         │   Access\"     │                  │   │\n│   │    │               │         │               │                  │   │\n│   │    │ • auth.ts     │         │ • db-client   │                  │   │\n│   │    │ • jwt.ts      │         │ • repository  │                  │   │\n│   │    │ • crypto.ts   │         │ • orm-utils   │                  │   │\n│   │    │ • session.ts  │         │ • migrations  │                  │   │\n│   │    │               │         │               │                  │   │\n│   │    │ Cohesion: 0.87│         │ Cohesion: 0.92│                  │   │\n│   │    └───────────────┘         └───────────────┘                  │   │\n│   │                                                                 │   │\n│   │    ┌───────────────┐         ┌───────────────┐                  │   │\n│   │    │  CLUSTER 3    │         │  CLUSTER 4    │                  │   │\n│   │    │  \"API         │         │  \"Visualiza-  │                  │   │\n│   │    │   Handlers\"   │         │   tion\"       │                  │   │\n│   │    │               │         │               │                  │   │\n│   │    │ • routes/     │         │ • graph-eng   │                  │   │\n│   │    │ • controllers │         │ • layout-alg  │                  │   │\n│   │    │ • middleware  │         │ • renderers   │                  │   │\n│   │    │ • validators  │         │ • d3-bindings │                  │   │\n│   │    │               │         │               │                  │   │\n│   │    │ Cohesion: 0.84│         │ Cohesion: 0.91│                  │   │\n│   │    └───────────────┘         └───────────────┘                  │   │\n│   │                                                                 │   │\n│   │              ┌───────────────┐                                  │   │\n│   │              │  CLUSTER 5    │                                  │   │\n│   │              │  \"Testing     │                                  │   │\n│   │              │   Utilities\"  │                                  │   │\n│   │              │               │                                  │   │\n│   │              │ • mocks/      │                                  │   │\n│   │              │ • fixtures/   │                                  │   │\n│   │              │ • helpers/    │                                  │   │\n│   │              │               │                                  │   │\n│   │              │ Cohesion: 0.78│                                  │   │\n│   │              └───────────────┘                                  │   │\n│   │                                                                 │   │\n│   └─────────────────────────────────────────────────────────────────┘   │\n│                                                                         │\n│   ALGORITHMS: kmeans | dbscan | hierarchical                            │\n│   AI-GENERATED LABELS: Using MageAgent multi-model consensus            │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n### 🏗️ Architecture Analyzer\n\nDetect code smells and get AI-powered refactoring suggestions.\n\n```\n@nexus nexusmind_architecture_analyze issueTypes=[\"circular-dependency\",\"god-class\"]\n```\n\n**Analysis Output:**\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│                    Architecture Analysis Report                          │\n├─────────────────────────────────────────────────────────────────────────┤\n│                                                                         │\n│  ⚠️  CIRCULAR DEPENDENCY DETECTED                     Confidence: 0.95  │\n│  ────────────────────────────────────────────────────────────────────   │\n│                                                                         │\n│      ┌──────────┐                                                       │\n│      │ UserSvc  │◄────────────────┐                                     │\n│      └────┬─────┘                 │                                     │\n│           │                       │                                     │\n│           ▼                       │                                     │\n│      ┌──────────┐           ┌─────┴────┐                                │\n│      │ AuthSvc  │──────────►│ TeamSvc  │                                │\n│      └──────────┘           └──────────┘                                │\n│                                                                         │\n│  Files Involved: user-service.ts, auth-service.ts, team-service.ts      │\n│  Suggested Fix: Extract shared logic to new AuthContext module          │\n│  Estimated Impact: 5 files affected, 2 test files need updates          │\n│                                                                         │\n├─────────────────────────────────────────────────────────────────────────┤\n│                                                                         │\n│  ⚠️  GOD CLASS DETECTED                               Confidence: 0.88  │\n│  ────────────────────────────────────────────────────────────────────   │\n│                                                                         │\n│  File: src/services/DataProcessor.ts                                    │\n│                                                                         │\n│  Metrics:                                                               │\n│  • Lines of Code: 1,247 (threshold: 500)                                │\n│  • Methods: 34 (threshold: 20)                                          │\n│  • Responsibilities: 7 distinct concerns identified                     │\n│                                                                         │\n│  Responsibilities Detected:                                             │\n│  1. Data validation        5. Caching                                   │\n│  2. Transformation         6. Logging                                   │\n│  3. Persistence            7. Event emission                            │\n│  4. API communication                                                   │\n│                                                                         │\n│  AI Refactoring Suggestion:                                             │\n│  \"Split into DataValidator, DataTransformer, DataRepository,            │\n│   CacheManager, and EventEmitter classes. Use composition to            │\n│   coordinate. This follows Single Responsibility Principle and          │\n│   makes each component independently testable.\"                         │\n│                                                                         │\n│  Refactoring Steps:                                                     │\n│  1. Extract DataValidator (validation methods)                          │\n│  2. Extract DataTransformer (transformation logic)                      │\n│  3. Extract DataRepository (persistence)                                │\n│  4. Create DataProcessorFacade to coordinate                            │\n│  5. Update 12 dependent files to use new interfaces                     │\n│                                                                         │\n│  Risk Level: MEDIUM (recommend feature branch + thorough testing)       │\n│                                                                         │\n├─────────────────────────────────────────────────────────────────────────┤\n│  ISSUE TYPES DETECTED                                                   │\n│  • Circular Dependencies: 1                                             │\n│  • God Classes: 1                                                       │\n│  • Feature Envy: 0                                                      │\n│  • Inappropriate Intimacy: 0                                            │\n│  • Dead Code: 3 (minor)                                                 │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n### 💬 Natural Language Graph Queries\n\nAsk questions about your codebase in plain English and get visual answers.\n\n```\n@nexus nexusmind_nl_query query=\"What depends on the authentication module?\"\n```\n\n**Example Queries \u0026 Responses:**\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│  Query: \"What depends on the authentication module?\"                    │\n├─────────────────────────────────────────────────────────────────────────┤\n│                                                                         │\n│  Interpreted as: DEPENDENCY_GRAPH operation                             │\n│  Root: src/auth/                                                        │\n│  Direction: REVERSE (what depends ON this)                              │\n│                                                                         │\n│  Results: 23 files depend on authentication                             │\n│                                                                         │\n│  Critical Dependencies (will break if auth changes):                    │\n│  • src/api/routes/user.ts                                               │\n│  • src/api/routes/admin.ts                                              │\n│  • src/middleware/protect.ts                                            │\n│                                                                         │\n│  Indirect Dependencies (may need updates):                              │\n│  • src/services/UserService.ts                                          │\n│  • src/services/TeamService.ts                                          │\n│  • ... and 18 more                                                      │\n│                                                                         │\n└─────────────────────────────────────────────────────────────────────────┘\n\n┌─────────────────────────────────────────────────────────────────────────┐\n│  Query: \"Show me the most frequently changed files this month\"          │\n├─────────────────────────────────────────────────────────────────────────┤\n│                                                                         │\n│  Interpreted as: EVOLUTION_TIMELINE + FREQUENCY_ANALYSIS                │\n│  Time Range: Last 30 days                                               │\n│                                                                         │\n│  Top Changed Files:                                                     │\n│  ████████████████████░░░░  src/server.ts (18 changes)                   │\n│  ██████████████░░░░░░░░░░  src/handlers/query.ts (12 changes)           │\n│  ████████████░░░░░░░░░░░░  src/types.ts (10 changes)                    │\n│  ██████████░░░░░░░░░░░░░░  src/clients/graphrag.ts (8 changes)          │\n│  ████████░░░░░░░░░░░░░░░░  src/visualization/graph.ts (6 changes)       │\n│                                                                         │\n│  AI Insight: \"server.ts has high churn - consider stabilizing API       │\n│              contracts or adding integration tests to catch regressions\"│\n│                                                                         │\n└─────────────────────────────────────────────────────────────────────────┘\n\n┌─────────────────────────────────────────────────────────────────────────┐\n│  Query: \"Find code similar to the retry logic in api-client.ts\"         │\n├─────────────────────────────────────────────────────────────────────────┤\n│                                                                         │\n│  Interpreted as: SEMANTIC_CLUSTER + SIMILARITY_SEARCH                   │\n│  Reference: src/clients/api-client.ts:45-78 (retry pattern)             │\n│                                                                         │\n│  Similar Patterns Found:                                                │\n│                                                                         │\n│  1. src/clients/graphrag-client.ts:89-115                               │\n│     Similarity: 0.94                                                    │\n│     Pattern: Exponential backoff with jitter                            │\n│                                                                         │\n│  2. src/jobs/sync-job.ts:23-56                                          │\n│     Similarity: 0.87                                                    │\n│     Pattern: Retry with max attempts                                    │\n│                                                                         │\n│  3. src/utils/resilience.ts:12-45                                       │\n│     Similarity: 0.82                                                    │\n│     Pattern: Circuit breaker with retry                                 │\n│                                                                         │\n│  AI Suggestion: \"Consider extracting common retry logic into a          │\n│                 shared utility to ensure consistent behavior\"           │\n│                                                                         │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Use Cases\n\n### 🆕 Onboarding New Developers\n\n**Challenge**: New team member needs to understand unfamiliar codebase quickly.\n\n```bash\n# Step 1: Get high-level architecture view\n@nexus nexusmind_dependency_graph rootFile=\"src/index.ts\" depth=2 layout=\"hierarchical\"\n\n# Step 2: Understand key module relationships\n@nexus nexusmind_semantic_clusters algorithm=\"kmeans\" numClusters=8\n\n# Step 3: Ask natural language questions\n@nexus nexusmind_nl_query query=\"What are the main entry points?\"\n@nexus nexusmind_nl_query query=\"How does data flow from API to database?\"\n```\n\n**Result**: Hours of exploration compressed into minutes with visual context.\n\n---\n\n### 🔧 Pre-Refactoring Analysis\n\n**Challenge**: Need to refactor a core module without breaking things.\n\n```bash\n# Step 1: Analyze impact before touching code\n@nexus nexusmind_impact_ripple entityId=\"UserService\" maxDepth=4\n\n# Step 2: Check for architectural issues\n@nexus nexusmind_architecture_analyze targetPath=\"src/services/\" includeRefactoringSuggestions=true\n\n# Step 3: Understand historical context\n@nexus nexusmind_evolution_timeline entity=\"src/services/UserService.ts\" granularity=\"month\"\n```\n\n**Result**: Know exactly what will break and get AI-powered refactoring steps.\n\n---\n\n### 🐛 Debugging Production Issues\n\n**Challenge**: Bug reported in production, need to find root cause fast.\n\n```bash\n# Step 1: Find all code related to the feature\n@nexus nexusmind_nl_query query=\"Show me all payment processing code\"\n\n# Step 2: Trace dependencies\n@nexus nexusmind_dependency_graph rootFile=\"src/payments/processor.ts\" depth=3\n\n# Step 3: Check recent changes\n@nexus nexusmind_evolution_timeline entity=\"src/payments/\" granularity=\"day\"\n```\n\n**Result**: Quickly narrow down suspect code and recent changes.\n\n---\n\n### 📚 Documentation \u0026 Knowledge Transfer\n\n**Challenge**: Need to document architecture for stakeholders.\n\n```bash\n# Step 1: Generate module overview\n@nexus nexusmind_semantic_clusters algorithm=\"hierarchical\"\n\n# Step 2: Document dependencies\n@nexus nexusmind_dependency_graph rootFile=\"src/index.ts\" depth=4 layout=\"hierarchical\"\n\n# Step 3: Identify technical debt\n@nexus nexusmind_architecture_analyze issueTypes=[\"circular-dependency\",\"god-class\",\"dead-code\"]\n```\n\n**Result**: Auto-generated visualizations for technical documentation.\n\n---\n\n### 🔒 Security Review\n\n**Challenge**: Audit codebase for security-sensitive code paths.\n\n```bash\n# Step 1: Find authentication-related code\n@nexus nexusmind_nl_query query=\"Find all authentication and authorization code\"\n\n# Step 2: Trace data flow to auth\n@nexus nexusmind_impact_ripple entityId=\"AuthService\" maxDepth=3 includeTests=true\n\n# Step 3: Check for vulnerability patterns\n@nexus nexusmind_architecture_analyze issueTypes=[\"inappropriate-intimacy\"]\n```\n\n**Result**: Visual map of security-critical code paths.\n\n---\n\n## Open Source — Free Forever\n\nThe full Nexus platform, MIT licensed, self-hosted. No artificial limits.\n\n### Included Free\n\n| Feature | Description |\n|---------|-------------|\n| **GraphRAG Search** | Semantic code search — understands *what* code does |\n| **Impact Analysis** | See every file, function, and test affected |\n| **Episodic Memory** | Git history + AI context — understand *why* code evolved |\n| **NexusMind Visualization** | All 6 visualization tools, no restrictions |\n| **File History** | Complete evolution timeline with commit correlation |\n| **6-Language AST** | Deep parsing for TypeScript, JavaScript, Python, Go, Rust, Java |\n\n---\n\n## Features\n\n### 🧠 Episodic Memory\nUnderstand *why* code was written by analyzing git commit history and connecting changes to their original intent.\n\n### 🔍 Impact Analysis\nSee ripple effects before making changes. Know exactly which files, functions, and tests will be affected.\n\n```\n@nexus analyze impact of changing UserService\n```\n\n### 💬 Natural Language Queries\nAsk questions about your codebase in plain English.\n\n```\n@nexus where is authentication handled?\n@nexus why was the cache invalidation changed last month?\n```\n\n### 🧪 AI Test Generation\nGenerate comprehensive test suites with a single command.\n\n```\n@nexus generate tests for UserService\n```\n\n### 🛡️ Security Scanning\nReal-time vulnerability detection across your dependency tree.\n\n```\n@nexus scan for vulnerabilities\n```\n\n### 🤖 Multi-Agent AI (30+ Models)\nOrchestration, Competition, and Collaboration modes for complex tasks.\n\n---\n\n## Quick Start\n\n### 1. Get Your API Key\n\n1. Sign up at [adverant.ai/pricing](https://adverant.ai/pricing)\n2. Go to Settings → API Keys\n3. Create a new API key for \"Cursor IDE\"\n\n### 2. Install \u0026 Configure\n\nAdd to your `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"nexus\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@adverant/nexus-cursor-plugin\"],\n      \"env\": {\n        \"NEXUS_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### 3. Start Using\n\n```\n# Core Tools\n@nexus explain this code\n@nexus analyze impact of changing UserService\n@nexus generate tests for PaymentService\n\n# NexusMind Visualization\n@nexus nexusmind_dependency_graph rootFile=\"src/index.ts\"\n@nexus nexusmind_evolution_timeline entity=\"src/server.ts\"\n@nexus nexusmind_impact_ripple entityId=\"AuthService\"\n@nexus nexusmind_semantic_clusters numClusters=5\n@nexus nexusmind_architecture_analyze\n@nexus nexusmind_nl_query query=\"What depends on the database module?\"\n```\n\n---\n\n## Available Tools\n\n### Core Tools\n\n| Tool | Description |\n|------|-------------|\n| `nexus_health` | Check connection to Nexus backend |\n| `nexus_index_repository` | Index repository for code intelligence |\n| `nexus_query` | Natural language codebase queries |\n| `nexus_explain_code` | Explain code with historical context |\n| `nexus_impact_analysis` | Analyze change ripple effects |\n| `nexus_file_history` | Get file evolution timeline |\n\n### NexusMind Visualization Tools\n\n| Tool | Description |\n|------|-------------|\n| `nexusmind_dependency_graph` | Build interactive dependency graphs |\n| `nexusmind_evolution_timeline` | Visualize code history over time |\n| `nexusmind_impact_ripple` | Show change propagation ripple effects |\n| `nexusmind_semantic_clusters` | AI-powered semantic code grouping |\n| `nexusmind_architecture_analyze` | Detect code smells, suggest refactoring |\n| `nexusmind_nl_query` | Natural language to graph operations |\n\n---\n\n## Configuration\n\n| Environment Variable | Description | Default |\n|---------------------|-------------|---------|\n| `NEXUS_API_KEY` | Your Adverant API key | Required |\n| `NEXUS_ENDPOINT` | API endpoint | `https://api.adverant.ai` |\n| `LOG_LEVEL` | Logging level | `info` |\n\n---\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                      Cursor IDE                              │\n└─────────────────────────┬───────────────────────────────────┘\n                          │ MCP Protocol (stdio)\n┌─────────────────────────▼───────────────────────────────────┐\n│              Nexus Cursor Plugin (MCP Server)                │\n│                                                              │\n│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐       │\n│  │ Tree-sitter  │  │    Git       │  │   GraphRAG   │       │\n│  │   Parsers    │  │   Service    │  │    Client    │       │\n│  └──────────────┘  └──────────────┘  └──────────────┘       │\n│                                                              │\n│  ┌──────────────────────────────────────────────────┐       │\n│  │           NexusMind Visualization Module          │       │\n│  │  ┌────────────┐  ┌────────────┐  ┌────────────┐  │       │\n│  │  │ Graph      │  │ Layout     │  │ Semantic   │  │       │\n│  │  │ Engine     │  │ Algorithms │  │ Clustering │  │       │\n│  │  └────────────┘  └────────────┘  └────────────┘  │       │\n│  │  ┌────────────┐  ┌────────────┐  ┌────────────┐  │       │\n│  │  │ Evolution  │  │ Impact     │  │ NL Query   │  │       │\n│  │  │ Timeline   │  │ Ripple     │  │ Processor  │  │       │\n│  │  └────────────┘  └────────────┘  └────────────┘  │       │\n│  └──────────────────────────────────────────────────┘       │\n└─────────────────────────┬───────────────────────────────────┘\n                          │ HTTPS + WebSocket\n┌─────────────────────────▼───────────────────────────────────┐\n│                 Adverant Nexus Platform                      │\n│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐    │\n│  │ GraphRAG │  │MageAgent │  │  Neo4j   │  │  Qdrant  │    │\n│  │ Service  │  │ (30+ LLMs)│  │  Graph   │  │ Vectors  │    │\n│  └──────────┘  └──────────┘  └──────────┘  └──────────┘    │\n└─────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Development\n\n### Prerequisites\n\n- Node.js 20+\n- npm or yarn\n\n### Setup\n\n```bash\ngit clone https://github.com/adverant/nexus-cursor-plugin.git\ncd nexus-cursor-plugin\nnpm install\nnpm run build\nnpm test\n```\n\n### Project Structure\n\n```\nnexus-cursor-plugin/\n├── src/\n│   ├── server.ts              # MCP server implementation\n│   ├── types.ts               # TypeScript type definitions\n│   ├── clients/               # GraphRAG \u0026 MageAgent clients\n│   ├── handlers/              # Query, Impact, Episodic Memory\n│   ├── visualization/         # NexusMind module (NEW)\n│   │   ├── graph-engine.ts    # Core graph data structures\n│   │   ├── layout-algorithms.ts\n│   │   ├── dependency-graph.ts\n│   │   ├── evolution-timeline.ts\n│   │   ├── impact-ripple.ts\n│   │   ├── semantic-clusters.ts\n│   │   ├── architecture-advisor.ts\n│   │   └── nl-graph-query.ts\n│   ├── tools/                 # Security Scanner, Test Generator\n│   ├── parsers/               # Tree-sitter AST parsing\n│   ├── git/                   # Git integration\n│   └── __tests__/             # Test suites (185 tests)\n├── docs/                      # Documentation\n└── README.md\n```\n\n### Running Tests\n\n```bash\nnpm test                    # Run all 185 tests\nnpm run test:coverage       # Run with coverage\nnpm test -- --grep \"visualization\"  # Run visualization tests only\n```\n\n---\n\n## Pricing\n\n| Tier | Price | What You Get |\n|------|-------|--------------|\n| **Open Source** | $0/mo | Full platform including NexusMind. MIT licensed. |\n| **Shared Access** | $9/mo | + Knowledge Circles, Cloud Sync, BYOK for 30+ LLMs |\n| **Teams** | $199/mo | + SSO/SAML, Admin Controls, Priority Support |\n| **Dedicated VPS** | $499/mo | + Dedicated Infrastructure, Custom Integrations |\n\n[View full pricing details →](https://adverant.ai/pricing)\n\n---\n\n## Support\n\n- **Documentation**: [adverant.ai/docs](https://adverant.ai/docs)\n- **Issues**: [GitHub Issues](https://github.com/adverant/nexus-cursor-plugin/issues)\n- **Email**: support@adverant.ai\n- **Discord**: [Join our community](https://discord.gg/adverant)\n\n---\n\n## License\n\nMIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cstrong\u003eBuilt with ❤️ by \u003ca href=\"https://adverant.ai\"\u003eAdverant\u003c/a\u003e\u003c/strong\u003e\n\n  \u003cbr/\u003e\u003cbr/\u003e\n\n  \u003ca href=\"https://adverant.ai\"\u003eWebsite\u003c/a\u003e •\n  \u003ca href=\"https://adverant.ai/docs\"\u003eDocs\u003c/a\u003e •\n  \u003ca href=\"https://twitter.com/adverant\"\u003eTwitter\u003c/a\u003e •\n  \u003ca href=\"https://discord.gg/adverant\"\u003eDiscord\u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadverant%2Fnexus-cursor-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadverant%2Fnexus-cursor-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadverant%2Fnexus-cursor-plugin/lists"}