Ccc

1---2name: ccc3description: "This skill should be used when code search is needed (whether explicitly requested or as part of completing a task), when indexing the codebase after changes, or when the user asks about ccc, cocoindex-code, or the codebase index. Trigger phrases include 'search the codebase', 'find code related to', 'update the index', 'ccc', 'cocoindex-code'."4---5 6# ccc - Semantic Code Search & Indexing7 8`ccc` is the CLI for CocoIndex Code, providing semantic search over the current codebase and index management.9 10## Ownership11 12The agent owns the `ccc` lifecycle for the current project — initialization, indexing, and searching. Do not ask the user to perform these steps; handle them automatically.13 14- **Initialization**: If `ccc search` or `ccc index` fails with an initialization error (e.g., "Not in an initialized project directory"), run `ccc init` from the project root directory, then `ccc index` to build the index, then retry the original command.15- **Index freshness**: Keep the index up to date by running `ccc index` (or `ccc search --refresh`) when the index may be stale — e.g., at the start of a session, or after making significant code changes (new files, refactors, renamed modules). There is no need to re-index between consecutive searches if no code was changed in between.16- **Installation**: If `ccc` itself is not found (command not found), refer to [management.md](references/management.md) for installation instructions and inform the user.17 18## Searching the Codebase19 20To perform a semantic search:21 22```bash23ccc search <query terms>24```25 26The query should describe the concept, functionality, or behavior to find, not exact code syntax. For example:27 28```bash29ccc search database connection pooling30ccc search user authentication flow31ccc search error handling retry logic32```33 34### Filtering Results35 36- **By language** (`--lang`, repeatable): restrict results to specific languages.37 38  ```bash39  ccc search --lang python --lang markdown database schema40  ```41 42- **By path** (`--path`): restrict results to a glob pattern relative to project root. If omitted, defaults to the current working directory (only results under that subdirectory are returned).43 44  ```bash45  ccc search --path 'src/api/*' request validation46  ```47 48### Pagination49 50Results default to the first page. To retrieve additional results:51 52```bash53ccc search --offset 5 --limit 5 database schema54```55 56If all returned results look relevant, use `--offset` to fetch the next page — there are likely more useful matches beyond the first page.57 58### Working with Search Results59 60Search results include file paths and line ranges. To explore a result in more detail:61 62- Use the editor's built-in file reading capabilities (e.g., the `Read` tool) to load the matched file and read lines around the returned range for full context.63- When working in a terminal without a file-reading tool, use `sed -n '<start>,<end>p' <file>` to extract a specific line range.64 65## Settings66 67To view or edit embedding model configuration, include/exclude patterns, or language overrides, see [settings.md](references/settings.md).68 69## Management & Troubleshooting70 71For installation, initialization, daemon management, troubleshooting, and cleanup commands, see [management.md](references/management.md).