$git clone https://github.com/cocoindex-io/cocoindex-codeA lightweight, effective (AST-based) semantic code search tool for your codebase. Built on CocoIndex — a Rust-based ultra performant data transformation engine. Use it from the CLI, or integrate with Claude, Codex, Cursor — any cod
| 1 | <p align="center"> |
| 2 | <img width="2428" alt="cocoindex code" src="https://github.com/user-attachments/assets/d05961b4-0b7b-42ea-834a-59c3c01717ca" /> |
| 3 | </p> |
| 4 | |
| 5 | |
| 6 | <h1 align="center">AST-based semantic code search that just works</h1> |
| 7 | |
| 8 |  |
| 9 | |
| 10 | |
| 11 | A lightweight, effective **(AST-based)** semantic code search tool for your codebase. Built on [CocoIndex](https://github.com/cocoindex-io/cocoindex) — a Rust-based ultra performant data transformation engine. Use it from the CLI, or integrate with Claude, Codex, Cursor — any coding agent — via [Skill](#skill-recommended) or [MCP](#mcp-server). |
| 12 | |
| 13 | - Instant token saving by 70%. |
| 14 | - **1 min setup** — install and go, zero config needed! |
| 15 | |
| 16 | <div align="center"> |
| 17 | |
| 18 | [](https://discord.com/invite/zpA9S2DR7s) |
| 19 | [](https://github.com/cocoindex-io/cocoindex) |
| 20 | [](https://cocoindex.io/docs/getting_started/quickstart) |
| 21 | [](https://opensource.org/licenses/Apache-2.0) |
| 22 | <!--[](https://pypistats.org/packages/cocoindex) --> |
| 23 | [](https://pepy.tech/projects/cocoindex) |
| 24 | [](https://github.com/cocoindex-io/cocoindex/actions/workflows/CI.yml) |
| 25 | [](https://github.com/cocoindex-io/cocoindex/actions/workflows/release.yml) |
| 26 | |
| 27 | |
| 28 | 🌟 Please help star [CocoIndex](https://github.com/cocoindex-io/cocoindex) if you like this project! |
| 29 | |
| 30 | [Deutsch](https://readme-i18n.com/cocoindex-io/cocoindex-code?lang=de) | |
| 31 | [English](https://readme-i18n.com/cocoindex-io/cocoindex-code?lang=en) | |
| 32 | [Español](https://readme-i18n.com/cocoindex-io/cocoindex-code?lang=es) | |
| 33 | [français](https://readme-i18n.com/cocoindex-io/cocoindex-code?lang=fr) | |
| 34 | [日本語](https://readme-i18n.com/cocoindex-io/cocoindex-code?lang=ja) | |
| 35 | [한국어](https://readme-i18n.com/cocoindex-io/cocoindex-code?lang=ko) | |
| 36 | [Português](https://readme-i18n.com/cocoindex-io/cocoindex-code?lang=pt) | |
| 37 | [Русский](https://readme-i18n.com/cocoindex-io/cocoindex-code?lang=ru) | |
| 38 | [中文](https://readme-i18n.com/cocoindex-io/cocoindex-code?lang=zh) |
| 39 | |
| 40 | </div> |
| 41 | |
| 42 | |
| 43 | ## Get Started — zero config, let's go! |
| 44 | |
| 45 | ### Install |
| 46 | |
| 47 | Using [pipx](https://pipx.pypa.io/stable/installation/): |
| 48 | ```bash |
| 49 | pipx install 'cocoindex-code[full]' # batteries included (local embeddings) |
| 50 | pipx upgrade cocoindex-code # upgrade |
| 51 | ``` |
| 52 | |
| 53 | Using [uv](https://docs.astral.sh/uv/getting-started/installation/): |
| 54 | ```bash |
| 55 | uv tool install --upgrade 'cocoindex-code[full]' |
| 56 | ``` |
| 57 | |
| 58 | Two install styles — they mirror the Docker image variants of the same names: |
| 59 | - `cocoindex-code[full]` — batteries-included. Pulls in `sentence-transformers` so local embeddings (no API key required) work out of the box. The `ccc init` interactive prompt defaults to [Snowflake/snowflake-arctic-embed-xs](https://huggingface.co/Snowflake/snowflake-arctic-embed-xs). |
| 60 | - `cocoindex-code` (slim) — LiteLLM-only; requires a cloud embedding provider and API key. Use when you don't want the local-embedding deps (~1 GB of torch + transformers). |
| 61 | |
| 62 | Next, set up your [coding agent integration](#coding-agent-integration) — or jump to [Manual CLI Usage](#manual-cli-usage) if you prefer direct control. |
| 63 | |
| 64 | ## Coding Agent Integration |
| 65 | |
| 66 | This repository is a **single plugin marketplace** (`.claude-plugin/marketplace.json`) consumed by both **Claude Code** and **Grok** — same plugin id `cocoindex-code`, same `ccc` skill. Grok o |