Back to the catalog

srclight

Deep code indexing for AI agents. Gives Claude Code structural understanding of entire codebases — symbol search, call graphs, type hierarch

Open source Repository Open in the app JSON README (API)

About

Deep code indexing for AI agents. Gives Claude Code structural understanding of entire codebases — symbol search, call graphs, type hierarchies, git blame/hotspots, dead code detection, and semantic search. 28 MCP tools across 11 languages (Python, JS/TS, C, C++, C#, Java, Kotlin, Go, Swift, Dart, PHP). Fully local, zero telemetry, MIT licensed.

Details

Kind
Plugins
Topic
AI, RAG & memory
Publisher
srclight
Origin
marketplace
Category
ferramentas
Stars
1
Last push
2026-03-23T16:21:28Z
Repository state
ativo
Language
Shell
License
MIT
Added
2026-08-30 01:48:58
Updated
2026-08-30 01:48:58
Origin id
srclight/claude-code-plugin/srclight

README

# srclight — Claude Code Plugin

Deep code indexing for AI agents. Structural code search, call graphs, type hierarchies, git intelligence, and dead code detection — all via MCP.

## Install

From within Claude Code:

```
/plugin marketplace add srclight/claude-code-plugin
/plugin install srclight
```

Or if srclight is in the official marketplace:

```
/plugin install srclight@claude-plugins-official
```

## What You Get

### MCP Server (auto-configured)

28 tools for structural code understanding — no manual MCP configuration needed:

| Category | Tools |
|----------|-------|
| **Search** | `hybrid_search`, `search_symbols`, `semantic_search`, `get_symbol`, `get_signature`, `symbols_in_file` |
| **Call Graphs** | `get_callers`, `get_callees`, `get_dependents`, `get_implementors`, `get_tests_for`, `get_type_hierarchy` |
| **Git Intelligence** | `blame_symbol`, `recent_changes`, `git_hotspots`, `whats_changed`, `changes_to` |
| **Code Quality** | `find_dead_code`, `find_imports`, `find_pattern` |
| **Build & Platform** | `get_build_targets`, `get_platform_variants`, `platform_conditionals` |
| **Meta** | `codebase_map`, `list_projects`, `index_status`, `embedding_status`, `reindex` |

### Skills

- **codebase-indexing** — Teaches Claude when and how to use each srclight tool
- **setup** — `/srclight:setup` command to index a project and configure embeddings
- **explore-codebase** — Systematic codebase exploration workflow
- **refactor-safely** — Pre-change safety checklist using call graphs

### Agent

- **codebase-explorer** — Autonomous deep research: architecture mapping, dependency auditing, dead code sweeps

## How It Works

The plugin auto-starts srclight as an MCP server via `uvx` (no manual install needed). On first use, index your project:

```
/srclight:setup
```

Or manually:

```bash
srclight index .
srclight index . --embed qwen3-embedding  # adds semantic search
```

Then just code — Claude will automatically use srclight tools when structural understanding is needed.

## vs srclight-app

This plugin is for **Claude Code users** who want code intelligence in the terminal. [srclight-app](https://github.com/srclight/srclight-app) is the full desktop GUI with dashboard, health monitoring, and visual workspace management.

## Supported Languages

Python, JavaScript/TypeScript, C, C++, C#, Java, Kotlin, Go, Swift, Dart, PHP

## Requirements

- Python 3.11+ (or `uv` for automatic management via `uvx`)
- Optional: [Ollama](https://ollama.com) for local semantic embeddings

## Links

- [srclight on GitHub](https://github.com/srclight/srclight)
- [srclight on PyPI](https://pypi.org/project/srclight/)
- [Documentation](https://github.com/srclight/srclight/tree/master/docs)
- [srclight.dev](https://srclight.dev)

More