1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
# MemFork client adapter registry (DESIGN §6.1).
#
# One entry per MCP client. Adding a client is an entry here plus a fixture
# test — never new code.
#
# `verified` is the date the entry was last checked against `docs`. Nothing in
# this file was confirmed by running the client; it is what the vendor's own
# documentation says on that date. Re-check before a release.
#
# Each entry has up to two ways in:
#
# [client.cli] the client's own `mcp add` command. Preferred, because the
# client then writes its own config in its own format and
# MemFork never parses a file it does not own. `status` asks
# the same command whether MemFork is registered, which is the
# only answer that counts: a client may store its servers
# somewhere MemFork does not model, or normalise what it was
# given, and reading its file would then disagree with it.
# [client.file] direct config editing. Used only when the client ships no
# CLI, or its CLI cannot express the requested scope. A client
# with no `user` path is one whose user configuration MemFork
# will not touch at all.
#
# In `add`, `{scope}` expands to zero or more flag tokens, `{name}` to the
# server name, `{command}` to the memfork binary path and `{args}` to its
# arguments. An expansion that produces nothing drops out of the command line.
#
# `remove` is how a registration that points at the wrong MemFork gets
# corrected: an install moves the binary, and the client keeps launching a path
# that is gone. A client with no documented `remove` is left alone and the
# command to run is printed instead, because guessing at a command that edits
# somebody's configuration is not a thing to do.
#
# `mcp_names` is what the client calls itself in MCP `initialize`, taken from
# its source code or its shipped build, since none of these document it. It is
# only used to show what a client wrote under the name a person knows; a
# client that is not listed is shown by the name it gave. A trailing `*`
# matches a prefix.
#
# [client.instructions] lists the files, relative to the repository root, that
# the client reads project instructions from on its own — only files it always
# reads, not ones it reads conditionally. `memfork init --project` writes its
# block into the fewest of these that reach every chosen client.
[[]]
= "claude-code"
= "Claude Code"
= "https://code.claude.com/docs/en/mcp"
= "2026-09-20"
# The directory this client creates for itself, so "installed but never
# configured" is not mistaken for "not installed".
= "$HOME/.claude"
# Found in the shipped build; not documented.
= ["claude-code"]
[]
= "claude"
= ["mcp", "add", "{scope}", "{name}", "--", "{command}", "{args}"]
# Asks about one server by name, rather than listing every server and
# health-checking each by starting it.
= ["mcp", "get", "{name}"]
# The scope flag follows the name here, unlike `add`.
= ["mcp", "remove", "{name}", "{scope}"]
= ["--scope", "user"]
= ["--scope", "project"]
[]
= "json"
= ["mcpServers"]
= true
= "url"
= ".mcp.json"
# No `user` path on purpose. This client keeps user-scope servers in
# `~/.claude.json`, together with its OAuth session, per-project trust settings
# and caches. MemFork neither writes nor reads that file: user scope goes
# through the `claude` command, and if that command is not on PATH, init writes
# project scope instead and says why. Leaving the path out of the registry is
# what makes that structural rather than a rule someone has to remember.
[]
# It also reads AGENTS.md, but only when there is no CLAUDE.md at or above the
# working directory, so that is not a file it can be relied on to read.
= ["CLAUDE.md"]
= "https://code.claude.com/docs/en/memory"
= "2026-09-21"
[[]]
= "cursor"
= "Cursor"
= "https://cursor.com/docs/context/mcp"
= "2026-09-20"
# The directory this client creates for itself, so "installed but never
# configured" is not mistaken for "not installed".
= "$HOME/.cursor"
# Cursor ships no `mcp add` command, so the config file is the only way in.
[]
= "json"
= ["mcpServers"]
= false
= "url"
= "$HOME/.cursor/mcp.json"
= ".cursor/mcp.json"
[]
# Also `.cursor/rules/*.mdc`, which need front matter; AGENTS.md is plain text.
= ["AGENTS.md"]
= "https://cursor.com/docs/context/rules"
= "2026-09-21"
[[]]
= "codex"
= "Codex CLI"
= "https://learn.chatgpt.com/docs/extend/mcp?surface=cli"
= "2026-09-20"
# The directory this client creates for itself, so "installed but never
# configured" is not mistaken for "not installed".
= "$HOME/.codex"
# From codex-rs/codex-mcp/src/rmcp_client.rs.
= ["codex-mcp-client"]
[]
= "codex"
= ["mcp", "add", "{name}", "--", "{command}", "{args}"]
= ["mcp", "remove", "{name}"]
# No `mcp get` is documented for this client, so registration is read off the
# list instead.
= ["mcp", "list"]
# No scope flag is documented: `codex mcp add` writes the user config. Project
# scope therefore falls back to editing `.codex/config.toml`.
= []
[]
= "toml"
= ["mcp_servers"]
= false
= "url"
= "$HOME/.codex/config.toml"
= ".codex/config.toml"
[]
= ["AGENTS.md"]
= "https://learn.chatgpt.com/docs/agent-configuration/agents-md"
= "2026-09-21"
[[]]
= "gemini-cli"
= "Gemini CLI"
= "https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md"
= "2026-09-20"
# The directory this client creates for itself, so "installed but never
# configured" is not mistaken for "not installed".
= "$HOME/.gemini"
# From packages/core/src/tools/mcp-client.ts.
= ["gemini-cli-mcp-client"]
[]
= "gemini"
# No `--` separator: the command and its arguments are positional.
= ["mcp", "add", "{scope}", "{name}", "{command}", "{args}"]
= ["mcp", "list"]
= ["mcp", "remove", "{scope}", "{name}"]
= ["-s", "user"]
= ["-s", "project"]
[]
= "json"
= ["mcpServers"]
= false
# The DESIGN §6.1 quirk: Gemini CLI uses `httpUrl` for streamable HTTP and `url`
# for SSE, where most clients use `url` for streamable HTTP. Unused until the
# shared daemon, encoded here so the difference is recorded once.
= "httpUrl"
= "$HOME/.gemini/settings.json"
= ".gemini/settings.json"
[]
# The default; `context.fileName` in its settings can change it.
= ["GEMINI.md"]
= "https://geminicli.com/docs/cli/gemini-md/"
= "2026-09-21"
[[]]
= "grok"
= "Grok Build"
= "https://docs.x.ai/build/features/mcp-servers"
= "2026-09-20"
# The directory this client creates for itself, so "installed but never
# configured" is not mistaken for "not installed".
= "$HOME/.grok"
# From crates/codegen/xai-grok-mcp/src/servers.rs: the configured server's name
# follows the prefix.
= ["grok-shell-*"]
[]
= "grok"
= ["mcp", "add", "{scope}", "{name}", "--", "{command}", "{args}"]
= ["mcp", "list"]
# No scope flag documented for remove, so none is sent.
= ["mcp", "remove", "{name}"]
# User scope is the default and takes no flag.
= []
= ["--scope", "project"]
[]
= "toml"
= ["mcp_servers"]
= false
= "url"
= "$HOME/.grok/config.toml"
= ".grok/config.toml"
[]
# It reads both, so it is reached by whichever the other clients need.
= ["AGENTS.md", "CLAUDE.md"]
= "https://docs.x.ai/build/features/project-rules"
= "2026-09-21"