Semantic Search

Copy MarkdownOpen

POST /v1/repos/:slug/index

{
  "branch": "main"
}

{
  "message": "Reindex queued",
  "repo_slug": "my-app",
  "branch": "main"
}

GET /v1/repos/:slug/index/status?branch=main

{
  "indexed": true,
  "status": "ready",
  "branch": "main",
  "last_commit_sha": "8b7d315321...",
  "chunks_count": 42,
  "total_batches": 1,
  "processed_batches": 1,
  "indexed_at": "2026-04-06T16:02:55.687Z",
  "error": null
}

POST /v1/repos/:slug/semantic-search

{
  "q": "user authentication with password verification",
  "ref": "main",
  "language": "typescript",
  "top_k": 10,
  "expand_context": false
}

{
  "results": [
    {
      "file_path": "src/services/user-service.ts",
      "score": 0.738,
      "language": "typescript",
      "start_line": 1,
      "end_line": 63,
      "snippet": "import { db } from \"../db\";\nimport { hash, compare } from \"bcrypt\";\n\nexport class UserService {\n  async authenticate(email: string, password: string) {\n    ...\n  }\n}"
    },
    {
      "file_path": "src/auth/middleware.ts",
      "score": 0.562,
      "language": "typescript",
      "start_line": 1,
      "end_line": 43,
      "snippet": "..."
    }
  ],
  "query": "user authentication with password verification",
  "repo_slug": "my-app",
  "ref": "main"
}

{
  "q": "database connection pooling",
  "ref": "8b7d3153212bdb9affd9a969cbdb2c17608aab87"
}

DELETE /v1/repos/:slug/index

{
  "branch": "feature-x"
}

{
  "deleted": true,
  "vectors_deleted": true
}

{
  "slug": "my-app",
  "auto_index": true
}

const git = createCoregitClient({ apiKey: "cgk_live_..." });

// 1. Trigger indexing
await git.search.triggerIndex("my-app", { branch: "main" });

// 2. Wait for indexing to complete
let status;
let attempts = 0;
do {
  const { data } = await git.search.indexStatus("my-app", "main");
  status = data?.status;
  if (status === "indexing" || status === "pending") {
    if (++attempts > 60) throw new Error("Indexing timed out");
    await new Promise(r => setTimeout(r, 2000));
  }
} while (status === "indexing" || status === "pending");

// 3. Search current branch
const { data } = await git.search.semantic("my-app", {
  q: "function that handles user login and session creation",
  ref: "main",
  top_k: 5,
});

for (const result of data.results) {
  console.log(`${result.file_path} (score: ${result.score.toFixed(2)})`);
  console.log(`  Lines ${result.start_line}-${result.end_line}`);
}

// 4. Search at a specific commit (version-aware)
const { data: oldVersion } = await git.search.semantic("my-app", {
  q: "authentication middleware",
  ref: "8b7d3153212bdb9affd9a969cbdb2c17608aab87",
});

// 5. Filter by language and path
const { data: tsResults } = await git.search.semantic("my-app", {
  q: "database connection pooling",
  ref: "feature-branch",
  language: "typescript",
  path_pattern: "src/**/*.ts",
});

// 6. Expand context around matches
const { data: withContext } = await git.search.semantic("my-app", {
  q: "error handling middleware",
  ref: "main",
  top_k: 5,
  expand_context: true,
});

for (const result of withContext.results) {
  if (result.context_before) console.log("--- before ---\n", result.context_before);
  console.log("--- match ---\n", result.snippet);
  if (result.context_after) console.log("--- after ---\n", result.context_after);
}