skills.rest
whiteboardev
whiteboardevCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

codebase-index

Index codebases for semantic search with incremental updates via Bun scripts.

Updated Jan 15, 2026
Search Tags:#indexing#codebase#semantic search#embeddings#code discovery#incremental updates
One-click install
npx skills add https://github.com/whiteboardev/brainy.chat --skill codebase-index-whiteboardev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-index
Source: https://github.com/whiteboardev/brainy.chat/tree/main/.opencode/skills/codebase
Command: npx skills add https://github.com/whiteboardev/brainy.chat --skill codebase-index-whiteboardev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires dotenv.

What problem does it solve?

This Skill indexes project files to enable semantic search over codebases, supporting incremental updates and embedding generation for fast, accurate code discovery.

Core Features & Use Cases

  • Incremental indexing: detects changes and indexes only modified files to keep embeddings fresh.
  • Full reindexing: creates new codebase records when starting from scratch.
  • Embedding generation and search: produces vectors for fast semantic queries and code retrieval.
  • Use Case: Engineers need to locate all references to a function across a large repository and across multiple services.

Quick Start

Index a local project by running bun .opencode/skills/codebase/index.ts PROJECT_ID NAME PATH.

Frequently Asked Questions about codebase-index

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I index a codebase for semantic search?▼

You can index a codebase for semantic search by running the Bun script with project ID, name, and path arguments. It validates paths, detects existing codebases via API endpoints, and persists indexing results with metrics.

Can I do incremental indexing for modified files in a repository?▼

Yes, incremental indexing detects changes and indexes only modified files to keep embeddings fresh. This applies to existing codebases, while full reindexing creates new records from scratch.

Do I need Bun to run codebase indexing?▼

Yes, you need Bun to run codebase indexing because the script executes as a Bun-based file. You also need the dotenv dependency to manage environment variables during the process.

What is the best way to locate function references across multiple services?▼

The best way to locate function references across multiple services is using embedding-based retrieval. Indexing project files produces vectors for fast semantic queries and accurate code discovery.

What are the limitations of semantic search over codebases?▼

Limitations of semantic search over codebases include the need to run a Bun script for full or incremental updates and reliance on API endpoints to detect existing codebases.

Related Skills

Explore More Software Engineering Skills→
jon23djon23d
3

zod-env

Validate environment variables at startup using Zod schemas in TypeScript projects.

Community
Intermediate
parcadeiparcadei
3.9k

leann-search

Perform semantic search across a codebase using a vector index.

Community
Intermediate
brainbrewlabsbrainbrewlabs
7

documentation

Generate and update technical documentation for codebases and APIs.

Official
Intermediate
matthewharwoodmatthewharwood
1

bun-runtime

Integrate Bun runtime APIs into tooling scripts for local automation.

Community
Intermediate