From dolphin
Search across any repositories indexed with Dolphin. Use when searching for code implementations, finding functions or classes across repos, or looking up how something works in the codebase. Also use when the user mentions "search" or asks to look up or find something.
How this skill is triggered — by the user, by Claude, or both
Slash command
/dolphin:dolphin-searchThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Search indexed codebases using hybrid vector + keyword retrieval via the `dolphin` CLI.
Search indexed codebases using hybrid vector + keyword retrieval via the dolphin CLI.
uv run dolphin repos --json
Returns repos with name, path, model, and file/chunk counts. Run this first if you don't know which repos are indexed.
uv run dolphin search "your query" --json [options]
Key options:
| Flag | Description | Default |
|---|---|---|
--repo NAME / -r NAME | Filter to specific repo(s) (repeatable) | all repos |
--path PREFIX / -p PREFIX | Filter by path prefix (repeatable) | none |
--exclude-pattern GLOB / -x GLOB | Exclude glob pattern (repeatable) | none |
--lang LANG | Language filter: py, ts, js, md, sql, svelte (repeatable) | all |
--top-k N / -k N | Number of results | 8 |
--max-snippets N | Include content for top N hits | 0 |
--context-before N | Context lines before match | 0 |
--context-after N | Context lines after match | 0 |
--graph-context | Include knowledge graph relationships and entities | off |
--show-content / --verbose | Enrich results with code snippets (local and remote) | off |
--local / -l | Force local search (rarely needed — auto-fallback exists) | remote |
--json | Machine-readable JSON output | off |
Always use --json when calling from this skill so results are structured.
# Broad semantic search
uv run dolphin search "authentication middleware" --json -k 5
# Scoped to a repo and language
uv run dolphin search "database connection pooling" --json -r myapp --lang py -k 10
# With snippets for top 3 hits
uv run dolphin search "error handling" --json --max-snippets 3 --context-before 2 --context-after 2
# Exclude test files
uv run dolphin search "caching logic" --json -x "*.test.*" -x "tests/*"
# With graph context (shows imports, calls, type relationships)
uv run dolphin search "search backend" --json --graph-context -k 5
uv run dolphin chunk <chunk_id> --json
Use chunk IDs from search results to fetch full chunk content.
{
"query": "the search query",
"result_count": 5,
"hits": [
{
"rank": 1,
"chunk_id": "abc123",
"repo": "myapp",
"path": "src/auth/middleware.py",
"file_path": "/absolute/path/to/src/auth/middleware.py",
"start_line": 42,
"end_line": 78,
"score": 0.8721,
"language": "python",
"symbol_kind": "function",
"symbol_name": "verify_token",
"content": "def verify_token(...):\n ...",
"snippet": { "text": "..." }
}
]
}
file_path and line numbers from hits (use the Read tool directly — it's faster than dolphin chunk)dolphin chunk <chunk_id> --json if you need the exact indexed contentSearch auto-falls back to local mode when the API server is unavailable, so most queries work without a running server. If you need to start the server explicitly:
uv run dolphin serve
Use --local to force local-only search (bypasses the server entirely, slower startup).
npx claudepluginhub plasticbeachllc/dolphin --plugin dolphinProvides semantic search, grep, and call graph tracing across CodeAlive-indexed codebases. Use to search code, fetch artifacts, or query data sources.
Semantic codebase search — use for exploring code, finding implementations, and answering questions about any project. Searches using natural language queries, identifier names, or file paths. Returns ranked results using embedding-based similarity, BM25 keyword matching, symbol matching, import graph analysis, and git recency. Use this as the default exploration tool instead of grep when you don't know the exact text to search for.
Provides semantic code search and index management via the ccc CLI. Automatically initializes and refreshes the codebase index for relevant file retrieval.