socraticode

v1.11.0

Codebase intelligence: semantic search workflows, dependency graph analysis, and context artifact exploration for SocratiCode

CodexClaude Code2 skills1 MCP serverstdio

by Giancarlo ErraAGPL-3.0-only3.2kupdated 4 days ago

Source

$ git clone https://github.com/giancarloerra/SocratiCode

Clone the source, then follow the repository's marketplace instructions for your runtime. The repository root is the plugin root.

Layout

socraticode/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/codebase-exploration/SKILL.md
├── skills/codebase-management/SKILL.md
└── .mcp.json

Skills2

codebase-explorationskills/codebase-exploration/SKILL.md

Explore and understand codebases using SocratiCode semantic search, dependency graphs, and context artifacts. Use when exploring code, understanding architecture, finding functions/types, analysing dependencies, searching database schemas or API specs, or when socraticode/codebase_search tools are available. Activates when the user asks about code structure, wants to find where a feature lives, or needs to understand how code is organised.

codebase-managementskills/codebase-management/SKILL.md

Set up, index, and manage SocratiCode codebase indexing. Use when the user wants to index a project, check infrastructure health, start/stop file watching, configure context artifacts, troubleshoot indexing issues, manage the code graph, or any SocratiCode administrative task. Activates when the user mentions indexing, setting up search, SocratiCode infrastructure, or managing the codebase index.

MCP servers1

socraticodestdio

command: npx
args: -y socraticode

Manifests2

.codex-plugin/plugin.json

{
  "name": "socraticode",
  "version": "1.11.0",
  "description": "Codebase intelligence: semantic search workflows, dependency graph analysis, and context artifact exploration for SocratiCode",
  "author": {
    "name": "Giancarlo Erra",
    "email": "giancarlo@altaire.com",
    "url": "https://altaire.com"
  },
  "homepage": "https://github.com/giancarloerra/socraticode",
  "repository": "https://github.com/giancarloerra/socraticode",
  "license": "AGPL-3.0-only",
  "keywords": [
    "codebase",
    "search",
    "indexing",
    "dependency-graph",
    "semantic-search",
    "mcp"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "SocratiCode",
    "shortDescription": "Codebase intelligence: semantic search, dependency graphs, and context artifacts",
    "longDescription": "SocratiCode provides codebase intelligence through semantic search workflows, dependency graph analysis, and context artifact exploration. Index your codebase, search with hybrid semantic + keyword search, visualize module dependencies, and manage context artifacts.",
    "developerName": "Giancarlo Erra",
    "category": "Development",
    "capabilities": [
      "Read"
    ],
    "websiteURL": "https://github.com/giancarloerra/socraticode",
    "privacyPolicyURL": "https://github.com/giancarloerra/socraticode/blob/main/SECURITY.md",
    "termsOfServiceURL": "https://github.com/giancarloerra/socraticode/blob/main/LICENSE",
    "defaultPrompt": [
      "Use SocratiCode to search the codebase for authentication handling.",
      "Use SocratiCode to visualize the dependency graph of this project."
    ]
  }
}

.claude-plugin/plugin.json

{
  "name": "socraticode",
  "version": "1.11.0",
  "description": "Codebase intelligence — semantic search workflows, dependency graph analysis, and context artifact exploration for SocratiCode",
  "author": {
    "name": "Giancarlo Erra",
    "email": "giancarlo@altaire.com",
    "url": "https://altaire.com"
  },
  "homepage": "https://github.com/giancarloerra/socraticode",
  "repository": "https://github.com/giancarloerra/socraticode",
  "license": "AGPL-3.0-only",
  "keywords": [
    "codebase",
    "search",
    "indexing",
    "dependency-graph",
    "semantic-search",
    "mcp"
  ],
  "mcpServers": "./.mcp.json"
}