Agentic Search

Copy MarkdownOpen

POST /v1/repos/:slug/agentic-search
POST /v1/repos/:namespace/:slug/agentic-search

{
  "q": "Where is JWT verification implemented?",
  "ref": "main",
  "max_turns": 6,
  "structure_depth": 2,
  "stream": false
}

{
  "answer": "JWT verification happens in src/auth/middleware.ts, line 42 (verifyJWT function).",
  "locations": [
    { "path": "src/auth/middleware.ts", "start_line": 42, "end_line": 58 },
    { "path": "src/auth/jwt.ts", "start_line": 1, "end_line": 25 }
  ],
  "total_turns": 4,
  "total_tokens": 286,
  "ref": "main",
  "commit_sha": "460c36eb28c301e31cda238af8b01c077e53b816"
}

data: {"type":"start","ref":"main","commit_sha":"460c36e...","workspace_ms":304}

data: {"type":"turn_start","turn":1}

data: {"type":"tool_call","turn":1,"call_id":"call_x","tool":"grep_search","args":{"pattern":"verifyJWT","path":"src"}}

data: {"type":"tool_result","turn":1,"call_id":"call_x","content":"src/auth/middleware.ts:42:  const token = verifyJWT(req.headers...","truncated":false}

data: {"type":"turn_end","turn":1,"prompt_tokens":1201,"completion_tokens":38}

data: {"type":"turn_start","turn":2}

data: {"type":"tool_call","turn":2,"call_id":"call_y","tool":"read","args":{"path":"src/auth/middleware.ts","start_line":35,"end_line":65}}

data: {"type":"tool_result","turn":2,"call_id":"call_y","content":"export function authMiddleware(...)...","truncated":false}

data: {"type":"turn_end","turn":2,"prompt_tokens":1340,"completion_tokens":24}

data: {"type":"finish","answer":"JWT verification happens in src/auth/middleware.ts...","locations":[{"path":"src/auth/middleware.ts","start_line":42,"end_line":58}],"total_turns":2,"total_tokens":62}

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

// Non-streaming
const { data } = await git.search.agentic("my-app", {
  q: "Where does user authentication happen?",
  ref: "main",
});

console.log(data.answer);
for (const loc of data.locations) {
  console.log(`  ${loc.path}:${loc.start_line}-${loc.end_line}`);
}

// Streaming
const result = await git.search.agenticStream(
  "my-app",
  { q: "Find the rate limiter", ref: "main" },
  (event) => {
    if (event.type === "tool_call") {
      console.log(`  → ${event.tool}(${JSON.stringify(event.args)})`);
    }
    if (event.type === "tool_result") {
      console.log(`  ← ${event.content.slice(0, 120)}`);
    }
  }
);

console.log("Final answer:", result?.answer);

# Buffered (one JSON response at the end)
cgt agentic my-app "Where is JWT verification?"

# Stream progress to stderr, final JSON to stdout
cgt agentic my-app "Where is JWT verification?" --stream
cgt agentic my-app "Where is JWT verification?" --stream --max-turns 8 --depth 3 --ref feature-branch