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 93f7d27
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/CONFIGURATION.md
+29Lines changed: 29 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -77,6 +77,7 @@ codebase-memory-mcp config list
77
77
codebase-memory-mcp config get auto_index
78
78
codebase-memory-mcp config set auto_index true
79
79
codebase-memory-mcp config set auto_index_limit 50000
80
+
codebase-memory-mcp config set watcher_enabled false
80
81
codebase-memory-mcp config reset auto_index
81
82
```
82
83
@@ -86,6 +87,34 @@ Current keys:
86
87
|---|---|---|
87
88
|`auto_index`|`false`| Automatically index new projects when an MCP session starts. |
88
89
|`auto_index_limit`|`50000`| Maximum file count allowed for automatic indexing of a new project. |
90
+
|`auto_watch`|`true`| Register the session's project with the background git watcher on connect. Set `false` to keep a session from registering its project (the watcher still runs for other projects). |
91
+
|`watcher_enabled`|`true`| Master switch for the background watcher subsystem. Set `false` to stop the watcher from starting at all — no poll thread and no project registration. Reindex manually with `index_repository` when disabled. |
92
+
93
+
> **`watcher_enabled` vs `auto_watch`.**`watcher_enabled` controls whether the
94
+
> watcher *subsystem* starts at all (the background poll thread). `auto_watch` is
95
+
> narrower: it only controls whether a connecting session registers *its own*
96
+
> project with an already-running watcher. When `watcher_enabled=false`,
97
+
> `auto_watch` has no effect — there is no watcher to register with.
98
+
>
99
+
> They also differ in **when they are read**, which matters because the watcher
100
+
> lives in the background daemon, not in your MCP client:
101
+
>
102
+
> -`auto_watch` is consulted each time a session would register its project, so
103
+
> a change applies to sessions that connect afterwards.
104
+
> -`watcher_enabled` is read **once, when the daemon starts**, because it decides
105
+
> whether the watcher is built at all. The daemon is long-lived and outlives
106
+
> individual MCP sessions, so **reconnecting your client is not enough** — retire
107
+
> the daemon so the next one picks the new value up:
108
+
>
109
+
> ```bash
110
+
> codebase-memory-mcp config set watcher_enabled false
111
+
> codebase-memory-mcp daemon stop # next session starts a daemon without the watcher
112
+
> codebase-memory-mcp daemon status # confirm
113
+
>```
114
+
>
115
+
> Disabling the watcher does not disable anything else: the daemon still starts,
116
+
>`auto_index` still runs, and `index_repository` stays available for manual
0 commit comments