From 9d113975dcdfdd000ba5c17478f02aa2b29d932e Mon Sep 17 00:00:00 2001 From: Giancarlo Erra Date: Mon, 27 Apr 2026 17:44:43 +0100 Subject: [PATCH] =?UTF-8?q?docs(readme):=20surface=20impact=20analysis=20&?= =?UTF-8?q?=20portability;=20fix=20Claude=20Code=20install=20-=20Add=20"Po?= =?UTF-8?q?rtable,=20AI-=20and=20host-agnostic"=20paragraph=20in=20the=20i?= =?UTF-8?q?ntro=20that=20=20=20bundles=20two=20claims:=20the=20codebase=20?= =?UTF-8?q?context=20lives=20with=20the=20code=20(works=20=20=20with=20any?= =?UTF-8?q?=20assistant=20/=20IDE=20/=20CLI,=20any=20combination),=20and?= =?UTF-8?q?=20pre-computed=20=20=20reasoning=20(blast=20radius,=20call-flo?= =?UTF-8?q?w,=20dependency=20traversal)=20lets=20=20=20smaller=20/=20cheap?= =?UTF-8?q?er=20models=20hold=20their=20own=20on=20architectural=20questio?= =?UTF-8?q?ns.=20-=20Add=20three=20rows=20to=20the=20"Built-in=20Code=20Se?= =?UTF-8?q?arch=20vs=20SocratiCode"=20=20=20comparison=20table:=20symbol-l?= =?UTF-8?q?evel=20impact=20/=20blast=20radius,=20call-flow=20=20=20tracing?= =?UTF-8?q?,=20interactive=20visual=20graph=20explorer.=20-=20Plugins=20se?= =?UTF-8?q?ction:=20chain=20Claude=20Code's=20two=20install=20commands=20w?= =?UTF-8?q?ith=20&&=20=20=20so=20the=20row=20is=20a=20single=20copy-paste?= =?UTF-8?q?=20=E2=80=94=20the=20install=20step=20was=20missing.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 57a6c3f..b7a5efa 100644 --- a/README.md +++ b/README.md @@ -34,13 +34,15 @@ > > 💬 Questions or just want to chat? Join us on [Discord](https://discord.gg/5DrMXfNG). -**One thing, done well: deep codebase intelligence — zero setup, no bloat, fully automatic.** SocratiCode gives AI assistants deep semantic understanding of your codebase — hybrid search, cross-project search, polyglot code dependency graphs, **symbol-level Impact Analysis** (the blast radius of any file or function change — use it BEFORE refactoring), an **interactive HTML graph explorer** for visual navigation, and searchable context artifacts (database schemas, API specs, infra configs, architecture docs). Zero configuration — add it to **any MCP host**, or install the native **plugin** for Claude Code, Cursor, VS Code Copilot, Codex or Gemini CLI. It manages everything automatically. +> **☁️ SocratiCode Cloud (private beta)** — Hosted, shared team index built on the same engine as the open-source version, plus SSO, audit logs, branch-aware indexing, and VPC / air-gapped deployment options. The open-source core remains free forever. [Request early access →](https://socraticode.cloud) -**Production-ready**, battle-tested on **enterprise-level** large repositories (up to and over **~40 million lines of code**). **Batched**, automatic **resumable** indexing checkpoints progress — pauses, crashes, restarts, and interruptions don't lose work. The file watcher keeps the **index automatically updated** at every file change and across sessions. **Multi-agent ready** — multiple AI agents can work on the same codebase simultaneously, sharing a single index with automatic coordination and zero configuration. +**One thing, done well: deep codebase intelligence — zero setup, no bloat, fully automatic.** SocratiCode gives AI assistants deep semantic understanding of your codebase — **hybrid search, cross-project search, polyglot code dependency graphs, symbol-level impact analysis and flow, interactive HTML graph explorer for visual navigation, and searchable context artifacts (database schemas, API specs, infra configs, architecture docs)**. Zero configuration — add it to **any MCP host**, or install the **Native Plugin** for Claude Code, Cursor, VS Code Copilot, Codex or Gemini CLI. It manages everything automatically. + +**Production-ready**, battle-tested on **enterprise-level** large repositories (up to and over **~40 million lines of code**). **Batched**, automatic **resumable** indexing checkpoints progress — pauses, crashes, restarts, and interruptions don't lose work. The file watcher keeps the **index automatically updated** at every file change and across sessions. **Multi-branch, multi-repo** and **multi-agent ready** — multiple AI agents can work on the same codebase simultaneously, sharing a single index with automatic coordination and zero configuration. **Private and local by default** — Docker handles everything, no API keys required, no data leaves your machine. **Cloud ready** for embeddings (OpenAI, Google Gemini) and Qdrant, and a **full suite of configuration options** are all available when you need them. -> **☁️ SocratiCode Cloud (private beta)** — Hosted, shared team index built on the same engine as the open-source version, plus SSO, audit logs, branch-aware indexing, and VPC / air-gapped deployment options. The open-source core remains free forever. [Request early access →](https://socraticode.cloud) +**Code intelligence that belongs to you, AI and host agnostic** — your codebase's understanding lives with the code, not locked to any one assistant, IDE or model. And because SocratiCode pre-computes the hard parts (blast radius, call-flow, dependency traversal), **smaller models can handle architectural complex tasks that would otherwise need top-tier reasoning**, saving even more on token cost. The first Qdrant‑based MCP/Claude Plugin/Skill that pairs auto‑managed, zero‑config local Docker deployment with **AST‑aware code chunking, hybrid semantic + BM25 (RRF‑fused) code search**, polyglot dependency **graphs** with circular‑dependency visualisation, **symbol‑level Impact Analysis** (blast‑radius & call‑flow tracing across 18 languages), and searchable **infra/API/database artifacts** in a single focused, zero-config and easy to use code intelligence engine. @@ -166,7 +168,7 @@ SocratiCode is available as a native plugin on multiple AI coding platforms. Plu | Platform | Install method | |:---------|:---------------| -| Claude Code | `claude plugin marketplace add giancarloerra/socraticode` — [full instructions](#claude-code-plugin-recommended-for-claude-code-users) | +| Claude Code | `claude plugin marketplace add giancarloerra/socraticode && claude plugin install socraticode@socraticode` — [full instructions](#claude-code-plugin-recommended-for-claude-code-users) | | Cursor | `/add-plugin https://github.com/giancarloerra/socraticode` | | VS Code Copilot | Command Palette → `Chat: Install Plugin From Source` → `https://github.com/giancarloerra/socraticode` | | Zed | Add as a custom MCP server in Zed settings — [config example](#zed) | @@ -206,6 +208,9 @@ I built SocratiCode because I regularly work on existing, large, and complex cod | Semantic search | — | ✅ | ✅¹ | ✅ | | Hybrid search (fused) | — | — | — | ✅ | | Code dependency graph | — | — | ✅² | ✅ | +| Symbol-level impact / blast radius | — | — | — | ✅ | +| Call-flow tracing (entry point → callees) | — | — | — | ✅ | +| Interactive visual graph explorer | — | — | — | ✅ | | Circular dependency detection | — | — | — | ✅ | | Non-code knowledge (schemas, API specs) | — | — | — | ✅ | | Cross-project search | — | — | — | ✅ |