@actions-json/bridge 0.1.119 → 0.1.120

package/README.md

@@ -3,42 +3,33 @@
 Run the [actions.json](https://yaniv256.github.io/actions.json/) MCP bridge with
 `npx` — no Rust toolchain required. On first run this downloads the prebuilt
 `actions-json-mcp` binary for your platform from the GitHub release, caches it,
-and runs it with the arguments you pass.
+and runs it. The primitive dictionary (browser-control tool catalog) is bundled,
+so you don't pass `--actions`.
 
 ## Usage
 
 ```bash
-npx @actions-json/bridge mcp \
-  --bind 0.0.0.0:17345 \
-  --actions /abs/path/to/overlay.actions.json \
-  --storage-root /abs/path/to/actions.json.storage
+npx @actions-json/bridge mcp --storage-root /path/to/.storage
 ```
 
-Register it with a coding agent the same way — for Claude Code:
+Register it with a coding agent — for Claude Code:
 
 ```bash
 claude mcp add actions-json -- \
-  npx -y @actions-json/bridge mcp \
-  --bind 0.0.0.0:17345 \
-  --actions /abs/path/to/overlay.actions.json \
-  --storage-root /abs/path/to/actions.json.storage
+  npx -y @actions-json/bridge mcp --storage-root /path/to/.storage
 ```
 
-For Codex (`~/.codex/config.toml`):
-
-```toml
-[mcp_servers.actions-json]
-command = "npx"
-args = [
-  "-y", "@actions-json/bridge", "mcp",
-  "--bind", "0.0.0.0:17345",
-  "--actions", "/abs/path/to/overlay.actions.json",
-  "--storage-root", "/abs/path/to/actions.json.storage",
-]
+For Codex:
+
+```bash
+codex mcp add actions-json -- \
+  npx -y @actions-json/bridge mcp --storage-root /path/to/.storage
 ```
 
-All arguments after the binary are passed straight through to `actions-json-mcp`.
-See [Getting Started](https://yaniv256.github.io/actions.json/getting-started.html).
+All arguments after the binary pass straight through to `actions-json-mcp`. To
+use a custom primitive dictionary, pass your own `--actions <file>` and the
+bundled default is skipped. See
+[Getting Started](https://yaniv256.github.io/actions.json/getting-started.html).
 
 ## Platforms
 

package/bin/cli.js

@@ -4,11 +4,28 @@
 // Thin launcher: ensure the prebuilt actions-json-mcp binary is present
 // (downloading it on first run), then exec it with whatever args were passed.
 // Example:
-//   npx @actions-json/bridge mcp --bind 0.0.0.0:17345 --actions ... --storage-root ...
+//   npx @actions-json/bridge mcp --storage-root .storage
 
+const path = require('node:path');
 const { spawn } = require('node:child_process');
 const { ensureBinary } = require('../lib/install');
 
+// The primitive dictionary (browser-control tool catalog) ships with this
+// package — it's a fixed runtime file, not user config. When the caller runs a
+// subcommand that needs it and didn't pass --actions, default to the bundled
+// copy so users don't have to know its path.
+const BUNDLED_ACTIONS = path.join(__dirname, '..', 'dictionary', 'overlay.actions.json');
+const SUBCOMMANDS_NEEDING_ACTIONS = new Set(['mcp', 'serve']);
+
+function withDefaultActions(args) {
+  const sub = args[0];
+  if (!SUBCOMMANDS_NEEDING_ACTIONS.has(sub)) return args;
+  if (args.includes('--actions')) return args;
+  if (args.includes('--help') || args.includes('-h')) return args;
+  // Insert right after the subcommand.
+  return [args[0], '--actions', BUNDLED_ACTIONS, ...args.slice(1)];
+}
+
 async function main() {
   let bin;
   try {
@@ -19,7 +36,7 @@ async function main() {
     return;
   }
 
-  const args = process.argv.slice(2);
+  const args = withDefaultActions(process.argv.slice(2));
   const child = spawn(bin, args, { stdio: 'inherit' });
 
   // Forward termination signals so the bridge shuts down cleanly.