vera-ccc-tools

Purpose

Expose CocoIndex Code (ccc) as native Pi/Vera tools so semantic code search and index management are available without going through raw bash.

Registered tools

• ccc_search — semantic code search via ccc search
• ccc_index — build or refresh the project index via ccc index
• ccc_init — initialize the current project for CocoIndex Code via ccc init
• ccc_status — show project index status via ccc status
• ccc_doctor — run CocoIndex diagnostics via ccc doctor

Design notes

• Uses the installed ccc executable from PATH
• Executes commands in the current project cwd
• Returns truncated text output suitable for the model context
• Keeps semantic search as a first-class tool while leaving exact file lookup to fd / rg / read

Non-goals

• replacing rg / fd for exact text or path lookup
• destructive reset / daemon stop controls
• direct MCP transport management

External dependencies

• ccc installed and available on PATH
• CocoIndex daemon health for index/search operations
• initialized project for ccc_status / ccc_search unless ccc_index or ccc_init has been run

Smoke

• npm run smoke
• from project root: node agent/packages/vera-ccc-tools/scripts/smoke.mjs

Loaded through agent/settings.json as ./packages/vera-ccc-tools.