realontext 0.15.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "realontext",
3
- "version": "0.15.0",
3
+ "version": "0.16.0",
4
4
  "description": "Code search for coding agents, over the directory you are in. Needs `npm install -g realontext`.",
5
5
  "author": {
6
6
  "name": "FlowerRealm",
package/lib/agents.js CHANGED
@@ -14,7 +14,8 @@
14
14
  // the directory `setup` runs in. Three things go in: the MCP server, everywhere;
15
15
  // the once-a-session reminder, where the agent has a hook that adds
16
16
  // context the model sees; the usage rules, where the agent is known not to
17
- // pass the server's instructions to the model. `hook` names the event the
17
+ // pass the server's instructions to the model, or its model was seen not to
18
+ // use the tool without them. `hook` names the event the
18
19
  // reminder answers and, with `flat`, that the answer is not wrapped in
19
20
  // `hookSpecificOutput`.
20
21
  "use strict";
@@ -55,7 +56,8 @@ const agents = {
55
56
  gemini: {
56
57
  name: "Gemini CLI",
57
58
  steps: [
58
- { run: "gemini mcp add realontext realontext mcp" },
59
+ // Trusted: in headless runs (`gemini -p`) Gemini CLI hides tools that need approval.
60
+ { run: "gemini mcp add --trust realontext realontext mcp" },
59
61
  // Gemini CLI drops what a BeforeTool hook adds; AfterTool's goes after the tool's result.
60
62
  {
61
63
  list: ".gemini/settings.json",
@@ -70,6 +72,8 @@ const agents = {
70
72
  name: "Qwen Code",
71
73
  steps: [
72
74
  { run: "qwen mcp add -s project realontext realontext mcp" },
75
+ // Qwen Code holds a project's new server until it is approved.
76
+ { run: "qwen mcp approve realontext" },
73
77
  // Qwen Code drops what a PreToolUse hook adds; PostToolUse's goes after the tool's result.
74
78
  { list: ".qwen/settings.json", at: ["hooks", "PostToolUse"], value: nested("qwen", "run_shell_command|grep_search") },
75
79
  ],
@@ -86,6 +90,18 @@ const agents = {
86
90
  ],
87
91
  hook: { event: "PostToolUse" },
88
92
  },
93
+ codebuddy: {
94
+ name: "CodeBuddy Code",
95
+ steps: [
96
+ // `alwaysLoad`: CodeBuddy defers MCP tools and ignores the tool's own `_meta`.
97
+ { run: `codebuddy mcp add-json realontext ${JSON.stringify(JSON.stringify({ ...SERVER, alwaysLoad: true }))}` },
98
+ // CodeBuddy drops what a PreToolUse hook adds; SessionStart's reaches the model.
99
+ { list: ".codebuddy/settings.local.json", at: ["hooks", "SessionStart"], value: nested("codebuddy") },
100
+ // It does not pass the server's instructions to the model.
101
+ { file: ".codebuddy/rules/realontext.md", text: `---\nalwaysApply: true\n---\n\n${RULES}` },
102
+ ],
103
+ hook: { event: "SessionStart" },
104
+ },
89
105
  copilot: {
90
106
  name: "GitHub Copilot CLI",
91
107
  steps: [
@@ -139,19 +155,48 @@ const agents = {
139
155
  },
140
156
  antigravity: {
141
157
  name: "Antigravity",
142
- steps: [{ json: "~/.gemini/antigravity/mcp_config.json", at: ["mcpServers", "realontext"], value: SERVER }],
158
+ steps: [
159
+ // Antigravity 2.x reads the global MCP file the CLI writes, not the old `antigravity/` one.
160
+ { json: "~/.gemini/config/mcp_config.json", at: ["mcpServers", "realontext"], value: SERVER },
161
+ // The same agent as Antigravity CLI: MCP tools only through `call_mcp_tool`.
162
+ { block: "AGENTS.md", text: RULES },
163
+ ],
143
164
  },
144
165
  agy: {
145
166
  name: "Antigravity CLI",
146
- steps: [{ run: "agy mcp add realontext realontext mcp" }],
167
+ steps: [
168
+ { run: "agy mcp add realontext realontext mcp" },
169
+ // Antigravity CLI shows MCP tools only through a generic `call_mcp_tool`: the rules name it.
170
+ { block: "AGENTS.md", text: RULES },
171
+ ],
147
172
  },
148
173
  zed: {
149
174
  name: "Zed",
150
175
  steps: [{ json: ".zed/settings.json", at: ["context_servers", "realontext"], value: SERVER }],
176
+ note: "Zed starts a project's context servers only once the folder is trusted: trust it when Zed asks.",
151
177
  },
152
178
  openclaw: {
153
179
  name: "OpenClaw",
154
- steps: [{ json: "~/.openclaw/openclaw.json", at: ["mcp", "servers", "realontext"], value: SERVER }],
180
+ steps: [
181
+ { json: "~/.openclaw/openclaw.json", at: ["mcp", "servers", "realontext"], value: SERVER },
182
+ // OpenClaw passes no server instructions and keeps MCP tools behind its Tool Search;
183
+ // a skill is what its prompt lists, by name and description.
184
+ {
185
+ file: "~/.openclaw/skills/realontext/SKILL.md",
186
+ text: `---\nname: realontext\ndescription: Read this before searching source code. Code is searched with the realontext__codebase-retrieval tool, not with grep, rg or find through exec: every time you need to find where something is in the code (a behavior, a definition, its callers).\n---\n\n${RULES}\nIn OpenClaw the tool is \`realontext__codebase-retrieval\`; when it is not in your tool list, find it with \`tool_search\` and call it with \`tool_call\`.\n`,
187
+ },
188
+ ],
189
+ },
190
+ cline: {
191
+ name: "Cline",
192
+ steps: [
193
+ { clear: "cline mcp remove realontext", run: "cline mcp add --yes realontext -- realontext mcp" },
194
+ // Cline has a search tool of its own and reaches for it first, unless the rules name it.
195
+ {
196
+ file: ".clinerules/realontext.md",
197
+ text: `${RULES}\nIn Cline the tool is \`realontext__codebase-retrieval\`, and it takes the place of \`search_codebase\`: search source code with it, not with \`search_codebase\` or \`run_commands\`.\n`,
198
+ },
199
+ ],
155
200
  },
156
201
  pi: {
157
202
  name: "Pi",
@@ -160,7 +205,17 @@ const agents = {
160
205
  },
161
206
  omp: {
162
207
  name: "Oh My Pi",
163
- steps: [{ json: "~/.omp/agent/mcp_config.json", at: ["mcpServers", "realontext"], value: SERVER }],
208
+ steps: [
209
+ { json: "~/.omp/agent/mcp.json", at: ["mcpServers", "realontext"], value: SERVER },
210
+ // Oh My Pi gives MCP servers 250 ms to list their tools before the first turn; a
211
+ // server that misses it is left out of that turn's prompt. 0 waits for it.
212
+ { run: "omp config set mcp.startupTimeoutMs 0" },
213
+ // Its own `find` and `grep` win otherwise.
214
+ {
215
+ file: ".omp/rules/realontext.md",
216
+ text: `---\ndescription: Code search with realontext\nalwaysApply: true\n---\n\n${RULES}\nIn Oh My Pi the tool is \`mcp__realontext_codebase_retrieval\` (or the device \`xd://mcp__realontext_codebase_retrieval\`), and it takes the place of \`find\` and \`grep\`: search source code with it, not with them.\n`,
217
+ },
218
+ ],
164
219
  },
165
220
  dsh: {
166
221
  name: "DeepSeek Harness",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "realontext",
3
- "version": "0.15.0",
3
+ "version": "0.16.0",
4
4
  "description": "Code search for coding agents, over the directory you are in. CLI and MCP server.",
5
5
  "license": "SEE LICENSE IN LICENSE",
6
6
  "repository": {
@@ -34,8 +34,8 @@
34
34
  "react": "^18.3.1"
35
35
  },
36
36
  "optionalDependencies": {
37
- "@realontext/darwin-arm64": "0.15.0",
38
- "@realontext/linux-x64": "0.15.0",
39
- "@realontext/win32-x64": "0.15.0"
37
+ "@realontext/darwin-arm64": "0.16.0",
38
+ "@realontext/linux-x64": "0.16.0",
39
+ "@realontext/win32-x64": "0.16.0"
40
40
  }
41
41
  }