You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit cb251ed
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: README.md
+29-1Lines changed: 29 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -669,12 +669,39 @@ JSON arguments can also be piped on stdin, for tools that take arguments. A tool
669
669
670
670
| Tool | Description |
671
671
|------|-------------|
672
-
|`index_repository`| Index a repository into the graph. Auto-sync keeps it fresh after that. |
672
+
|`index_repository`| Index a repository into the graph. Auto-sync keeps it fresh after that. Waits for the whole index by default; pass `async: true` to start it in the daemon and return at once, then poll with `status: true` (see below). |
673
673
|`list_projects`| List all indexed projects with node/edge counts. |
674
674
|`delete_project`| Remove a project and all its graph data. |
675
675
|`index_status`| Check indexing status of a project. |
676
676
|`check_index_coverage`| Check whether exact paths or a scope are indexed and fresh. A clean result means no recorded gap, not proof of completeness. |
677
677
678
+
**Long indexes and client call deadlines.** A synchronous `index_repository` on a large
679
+
repository can take longer than an MCP client allows one tool call (some IDE clients give up
680
+
after a fixed deadline). When a client cancels or disconnects, the daemon cancels an index that
681
+
nobody else is waiting for, so retrying the same blocking call never finishes. Use the async
682
+
mode instead:
683
+
684
+
1.`index_repository(repo_path="/abs/path", async: true)` starts the index in the daemon (or
685
+
joins the one already running for that project) and returns immediately with
686
+
`state` (`queued`/`running`). The job keeps running even if the client cancels, times out or
0 commit comments