expandai 0.1.0 → 0.1.1
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.
- package/README.md +10 -6
- package/build/dts/Mcp/Server.d.ts +1 -1
- package/build/esm/index.js +17 -17
- package/build/esm/main.js +143 -143
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# expandai
|
|
2
2
|
|
|
3
3
|
Unified CLI and MCP server for [ExpandAI](https://expand.ai). Fetch any URL as
|
|
4
|
-
clean markdown, and wire ExpandAI into Claude Code, Cursor, OpenCode, or
|
|
4
|
+
clean markdown, and wire ExpandAI into Claude Code, Cursor, OpenCode, Codex, or fx
|
|
5
5
|
as an MCP server, a runtime webfetch hook, or a skill.
|
|
6
6
|
|
|
7
7
|
## Install
|
|
@@ -107,6 +107,7 @@ agents never need to answer an interactive CLI prompt.
|
|
|
107
107
|
| OpenCode | ✓ | ✓ | ✓ |
|
|
108
108
|
| Cursor | ✓ | — | ✓ |
|
|
109
109
|
| Codex | ✓ | — | ✓ |
|
|
110
|
+
| fx | ✓ | — | ✓ |
|
|
110
111
|
|
|
111
112
|
`expandai init` is the recommended path because it configures the current
|
|
112
113
|
harness plus every other supported harness detected on the machine. The
|
|
@@ -116,10 +117,10 @@ component commands below remain expert tools for migrations and targeted repair:
|
|
|
116
117
|
upgrades the agent invisibly: every native web fetch it issues comes
|
|
117
118
|
back as ExpandAI markdown, no prompt changes required. The same step also
|
|
118
119
|
wires the MCP server. See [Recommended: `hook install`](#recommended-hook-install).
|
|
119
|
-
2. **Skill** (all
|
|
120
|
+
2. **Skill** (all five harnesses). `expandai skill install <host> <scope>`
|
|
120
121
|
is the lightest option. It drops a `SKILL.md` that teaches the agent when
|
|
121
122
|
to reach for `expandai fetch`.
|
|
122
|
-
3. **MCP server** (all
|
|
123
|
+
3. **MCP server** (all five harnesses). `expandai mcp install <host> <scope>`
|
|
123
124
|
exposes the full `fetch` API (snippets, screenshots, structured
|
|
124
125
|
extraction) as an MCP-callable tool.
|
|
125
126
|
|
|
@@ -264,7 +265,7 @@ has not inherited the updated `PATH`.
|
|
|
264
265
|
(`tool.execute.before` can only mutate args, not replace results, which is
|
|
265
266
|
why we run in `after`.)
|
|
266
267
|
|
|
267
|
-
Cursor and
|
|
268
|
+
Cursor, Codex, and fx don't expose a hook system, so `hook install` only accepts
|
|
268
269
|
`claude-code` and `opencode`. For those harnesses, use `skill install` +
|
|
269
270
|
`mcp install` instead.
|
|
270
271
|
|
|
@@ -272,13 +273,14 @@ Cursor and Codex don't expose a hook system, so `hook install` only accepts
|
|
|
272
273
|
|
|
273
274
|
The CLI ships a `SKILL.md` that teaches an agent when to reach for
|
|
274
275
|
`expandai fetch`. `SKILL.md` is the open-standard format that Claude Code,
|
|
275
|
-
Cursor, OpenCode, and
|
|
276
|
+
Cursor, OpenCode, Codex, and fx auto-discover for tool guidance.
|
|
276
277
|
|
|
277
278
|
```bash
|
|
278
279
|
expandai skill install claude-code global # ~/.claude/skills/expandai/
|
|
279
280
|
expandai skill install cursor project # <cwd>/.cursor/skills/expandai/
|
|
280
281
|
expandai skill install opencode global # ~/.config/opencode/skills/expandai/
|
|
281
282
|
expandai skill install codex project # <cwd>/.agents/skills/expandai/
|
|
283
|
+
expandai skill install fx global # ~/.fx/skills/expandai/
|
|
282
284
|
```
|
|
283
285
|
|
|
284
286
|
**Scope behavior.** `global` drops `SKILL.md` into the harness's user-level
|
|
@@ -294,7 +296,7 @@ the skill alongside a project so collaborators pick it up automatically.
|
|
|
294
296
|
screenshot, links, JSON extraction, etc.).
|
|
295
297
|
|
|
296
298
|
`hook install` already registers the MCP server on Claude Code and OpenCode,
|
|
297
|
-
so this command is mostly for Cursor and
|
|
299
|
+
so this command is mostly for Cursor, Codex, and fx, or for installing the MCP
|
|
298
300
|
server without the runtime hook:
|
|
299
301
|
|
|
300
302
|
```bash
|
|
@@ -306,6 +308,8 @@ expandai mcp install opencode global # ~/.config/opencode/opencode.json
|
|
|
306
308
|
expandai mcp install opencode project # <cwd>/opencode.json
|
|
307
309
|
expandai mcp install codex global # ~/.codex/config.toml
|
|
308
310
|
expandai mcp install codex project # <cwd>/.codex/config.toml
|
|
311
|
+
expandai mcp install fx global # ~/.fx/mcp.json
|
|
312
|
+
expandai mcp install fx project # <cwd>/.mcp.json (shared with Claude Code)
|
|
309
313
|
```
|
|
310
314
|
|
|
311
315
|
**Scope behavior.** `global` writes the `expandai` entry to the harness's
|
|
@@ -2,7 +2,7 @@ import { Layer } from 'effect';
|
|
|
2
2
|
export { CurrentRequestHeaders } from './RequestHeaders.js';
|
|
3
3
|
export declare const ServerInfo: {
|
|
4
4
|
readonly name: "expandai";
|
|
5
|
-
readonly version: "0.1.
|
|
5
|
+
readonly version: "0.1.1";
|
|
6
6
|
};
|
|
7
7
|
export declare const makeServerLayer: (options?: {
|
|
8
8
|
readonly includeDocs?: boolean;
|