From 7d77e2f08d55acbb5a3d00d2f887cd7b9993ec92 Mon Sep 17 00:00:00 2001 From: kivtxs <131401183+kivtxs@users.noreply.github.com> Date: Wed, 11 Nov 2026 12:54:29 -0500 Subject: [PATCH] Export of Offline-Protocol/CLI@326526e7a494: CLI 0.3.3, plugin 0.1.7 --- README.md | 14 +++--- SOURCE.json | 44 +++++++++---------- distribution/clients/README.md | 10 ++--- distribution/clients/codex.toml | 2 +- distribution/clients/continue.yaml | 4 +- distribution/clients/devin-desktop.json | 2 +- distribution/clients/mcp-stdio.json | 2 +- distribution/clients/priority-two.md | 6 +-- distribution/clients/vscode.json | 2 +- distribution/clients/zed.json | 2 +- .../cline/offline-protocol/entry.json | 2 +- distribution/mcp-registry/server.hosted.json | 2 +- distribution/mcp-registry/server.json | 4 +- gemini-extension.json | 4 +- .../.claude-plugin/plugin.json | 2 +- .../.codex-plugin/plugin.json | 2 +- plugins/offline-protocol/.mcp.json | 2 +- plugins/offline-protocol/README.md | 6 +-- plugins/offline-protocol/mcp.json | 2 +- plugins/offline-protocol/plugin.json | 2 +- .../build-with-offline-protocol/SKILL.md | 2 +- 21 files changed, 59 insertions(+), 59 deletions(-) diff --git a/README.md b/README.md index 60054de..68632a5 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ packages, read integration guides and workflows, plan an implementation, and scaffold or integrate a project on your machine. Every configuration runs the local MCP server from the published Offline -Protocol CLI, `npx -y @offline-protocol/cli@0.3.2 mcp serve`, or +Protocol CLI, `npx -y @offline-protocol/cli@0.3.3 mcp serve`, or connects to the hosted MCP server at `https://mcp.offlineprotocol.com/mcp`. The tools help you build an application. They do not discover nearby devices, operate a mesh or control live hardware. @@ -23,7 +23,7 @@ here; pull requests to this repository are reviewed and applied upstream. ## Requirements Node.js 18 or later with npx. The first run downloads the pinned CLI -(`@offline-protocol/cli@0.3.2`) from npm. Local tools need no Offline +(`@offline-protocol/cli@0.3.3`) from npm. Local tools need no Offline Protocol account and send no telemetry. The hosted server needs an application API key and its application ID from https://dev.offlineprotocol.com. @@ -46,7 +46,7 @@ codex plugin add offline-protocol@offline-protocol Or add only the MCP server: ```bash -codex mcp add offline-protocol -- npx -y @offline-protocol/cli@0.3.2 mcp serve +codex mcp add offline-protocol -- npx -y @offline-protocol/cli@0.3.3 mcp serve ``` ### Cursor @@ -68,7 +68,7 @@ gemini extensions install https://github.com/Offline-Protocol/offline-protocol-a ### VS Code with GitHub Copilot ```bash -code --add-mcp '{"name":"offline-protocol","type":"stdio","command":"npx","args":["-y","@offline-protocol/cli@0.3.2","mcp","serve"]}' +code --add-mcp '{"name":"offline-protocol","type":"stdio","command":"npx","args":["-y","@offline-protocol/cli@0.3.3","mcp","serve"]}' ``` For one workspace, copy `distribution/clients/vscode.json` to `.vscode/mcp.json`. @@ -76,7 +76,7 @@ For one workspace, copy `distribution/clients/vscode.json` to `.vscode/mcp.json` ### Cline ```bash -cline mcp install offline-protocol -- npx -y @offline-protocol/cli@0.3.2 mcp serve +cline mcp install offline-protocol -- npx -y @offline-protocol/cli@0.3.3 mcp serve ``` ### Devin @@ -88,7 +88,7 @@ devin plugins install Offline-Protocol/offline-protocol-agent-plugins#plugins/of ``` Devin (web): add a custom MCP server with transport stdio, command `npx` and -arguments `-y @offline-protocol/cli@0.3.2 mcp serve`. Devin Desktop: +arguments `-y @offline-protocol/cli@0.3.3 mcp serve`. Devin Desktop: `distribution/clients/devin-desktop.json`. ### Any other MCP client @@ -100,7 +100,7 @@ Use this server definition (also in `distribution/clients/mcp-stdio.json`): "mcpServers": { "offline-protocol": { "command": "npx", - "args": ["-y", "@offline-protocol/cli@0.3.2", "mcp", "serve"] + "args": ["-y", "@offline-protocol/cli@0.3.3", "mcp", "serve"] } } } diff --git a/SOURCE.json b/SOURCE.json index 7389dbd..11c8616 100644 --- a/SOURCE.json +++ b/SOURCE.json @@ -2,9 +2,9 @@ "repository": "Offline-Protocol/offline-protocol-agent-plugins", "source": { "repository": "Offline-Protocol/CLI", - "commit": "1ef5533d4d69e5c4cb8358c48017c4ccced8cd99" + "commit": "326526e7a494b24bb8999ed5e6b9400d687fbe69" }, - "cliPackage": "@offline-protocol/cli@0.3.2", + "cliPackage": "@offline-protocol/cli@0.3.3", "generator": "scripts/export-agent-plugins.mjs", "files": { ".agents/plugins/marketplace.json": "e0fe652d775a8c601d0ae194d438b89b889935a8990db207c94f32b4ece5d7c4", @@ -14,33 +14,33 @@ ".github/workflows/validate.yml": "34b96a05a1573b9e44ee2d9a03d503cf7c454d9b29a1b044c70ae112cc3201bb", "LICENSE": "cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30", "NOTICE": "0cb7199c9a7adecfe113f5e68248beb381ea3f95543586aee88921a0b81e4bcc", - "README.md": "dd3af4b128c795961cbbc93820f714345fa2fbe93ce08cf08cda1e5b6d564015", + "README.md": "b67e5cb38c834426793bc1efee95ba0be9436343b2d53ee9c30c0c7a030051fa", "SECURITY.md": "13353905286c9895c4ac3d3ccfcd7d031bcd0cacde13216d88666d58af4e3b1f", - "distribution/clients/README.md": "7d822f2771d0cbfd5eb060e9262ce9870f5221a43ededa01780865149a567dea", - "distribution/clients/codex.toml": "3b806f325f8412bf8c51d6a9087d9f86d0a705af622e2c33fdd9faf79e35a59b", + "distribution/clients/README.md": "64e6a1c1317d9ef40eae3317c8337c62ae5dfd2b0aae7226edd59053132d66e7", + "distribution/clients/codex.toml": "5f348546b2a6724432443c0d1c7ecbec03c1f5ea15119e62d35ff6c04b90e41d", "distribution/clients/continue-hosted.yaml": "c26a04a27e59512443ea2565fb47374b785e939e2e7490c68b1abf76fb156f62", - "distribution/clients/continue.yaml": "7b2db100c79af40ba81d8f51d94d4ef06f2935db8f80deb5cd5ec9451e1df76b", + "distribution/clients/continue.yaml": "e3ecb791c10f385e8045ce190ac57f95573deab277cf1157f605d99be69e0edc", "distribution/clients/devin-desktop-hosted.json": "1380d9d606b3aaf3891f4b0c85739a8f85bbf4165191c87f7a52aaee743477dc", - "distribution/clients/devin-desktop.json": "ed6c225194407f3f2ebaffd3fa47644312be1e705617cc2034d4c1d9aa6573fc", - "distribution/clients/mcp-stdio.json": "ed6c225194407f3f2ebaffd3fa47644312be1e705617cc2034d4c1d9aa6573fc", - "distribution/clients/priority-two.md": "82d7456a91849344ab7264fb1f3aee76cf632d5bac326e98c82d737dce38b506", - "distribution/clients/vscode.json": "e373cb57b36d05b6acea2b66bbec11a6b88ecb2ba084d775ad27c5386979e37f", + "distribution/clients/devin-desktop.json": "c60cfc70ca32bce35ea233acb5e71a37a24e452423f7e64e66724904e0694518", + "distribution/clients/mcp-stdio.json": "c60cfc70ca32bce35ea233acb5e71a37a24e452423f7e64e66724904e0694518", + "distribution/clients/priority-two.md": "bdb58ecd971de7a05b7c107b5e36346c53d163e4b5dd855fadd7edcd17ee6e78", + "distribution/clients/vscode.json": "ace531ee882d1cb0fe62aabb01cadcb94f993e0f5fea76caf7d4debfee1ed03d", "distribution/clients/xai-responses.json": "94fca03563997032fdbf18a36abd14a317d991879ee64e5cb20451fa5c4c353d", "distribution/clients/zed-hosted.json": "ebb83b967a3f34e73e33ce9d195dbc66f100e1d4739c2d9d20d7cd9d90f37fea", - "distribution/clients/zed.json": "059358c6761798d19e1df7796724843094469f098126fb87acbc1faaa53297d6", + "distribution/clients/zed.json": "18faf33a4b00a2ddb9de5303787d129db3e45ac4be8dc190b8fcc168af8e40f3", "distribution/cline/logo-400.png": "3e04c6a8e4cdfc73e94a1dd7b2eb73ae6c94327f1fe91b83ac0623575611e16e", - "distribution/cline/offline-protocol/entry.json": "24b183fc721a36dfb58e46e9e082e962546580c7d89a3f2f495776e9c2b7b8ff", + "distribution/cline/offline-protocol/entry.json": "2564672dbb380e459c7f13eccf8ef10b518b2ae5c0e2046ea49aced6c27d77f6", "distribution/cline/offline-protocol/icon.svg": "2ede07df9324f8281339318b728267f19a01d5d23fb351c191612062a745eb43", - "distribution/mcp-registry/server.hosted.json": "c9d0c65fefa50ffaac628844ebc538c4a37696910ae38fd61b00bb83c1dde909", - "distribution/mcp-registry/server.json": "2e7c97bcdf18f5d5d7c9393114e9b0a276a2576cdd20b21341fe6a8f68fb9fc0", - "gemini-extension.json": "2c9bce822c34c651b14df8fc128c1cc4cead9e974f2b70f74d0eed8508651ca7", - "plugins/offline-protocol/.claude-plugin/plugin.json": "a8846e41f9cf1987cb21b5d41f3e5d8ed70e28b0d816e3335dfb206615f9cd2b", - "plugins/offline-protocol/.codex-plugin/plugin.json": "d01f42feae68568ba73515ca268e5320c83f3b81823eb52b032b005e26d9e699", - "plugins/offline-protocol/.mcp.json": "ed6c225194407f3f2ebaffd3fa47644312be1e705617cc2034d4c1d9aa6573fc", - "plugins/offline-protocol/README.md": "d4200e6ecb7610e3a6f83d48c21f9d06d3f877727200dde6867842379774b07b", + "distribution/mcp-registry/server.hosted.json": "b1df67a507a78f09820a86ac9685faa73533299e813e4d51b537c6865e31df68", + "distribution/mcp-registry/server.json": "e07e3bf6b9c29b62d62e60def7307faa0caf497547e893fc1846da73cb395df0", + "gemini-extension.json": "6e8aa1e53a3ee70a00f7cfedfc91dbdece3128851fffee054f3694cf58b595cd", + "plugins/offline-protocol/.claude-plugin/plugin.json": "591d4ed7d5153445e326b311ede94c925d94d6263ed9f7e1c29b5b1354cba2ca", + "plugins/offline-protocol/.codex-plugin/plugin.json": "49b2ad4b872d5c61a73a0efaecff4337bb19505d14f0bbf589b6ce1674bfcf48", + "plugins/offline-protocol/.mcp.json": "c60cfc70ca32bce35ea233acb5e71a37a24e452423f7e64e66724904e0694518", + "plugins/offline-protocol/README.md": "fb58d333cef1314779151a9bdc953a48daead0d9a4aa795f380660b618daf896", "plugins/offline-protocol/assets/logo.png": "8268382b80cd9e25a1509a1accdde7feae2233fd91bd5f041069d7fffcd8ade5", - "plugins/offline-protocol/mcp.json": "af876497a4d219c9388323ef046f7469791a27c46b7e01c517f7961063526ec2", - "plugins/offline-protocol/plugin.json": "b4e5a147f77faf25e85401b2687d1aa13a5e79a1b3781908a1a3d4a9a2f09137", - "plugins/offline-protocol/skills/build-with-offline-protocol/SKILL.md": "84502fb0cf5ca64e66fa4d4192a67c29340219f09b216afd46ff3669de294398" + "plugins/offline-protocol/mcp.json": "eaef709c79253957c4edabc83da9e2a3c9aa36d146c34ff05c9916a74c93830f", + "plugins/offline-protocol/plugin.json": "6192722850c5361c0e08be58e88aac396b93cf0b5c4f8fc80a872a5afca90664", + "plugins/offline-protocol/skills/build-with-offline-protocol/SKILL.md": "ce8e9b1c7edef243b74a265330f453f15d9a44f59d9184a68a42bdd0f833a11e" } } diff --git a/distribution/clients/README.md b/distribution/clients/README.md index 79e6a30..0e73d8d 100644 --- a/distribution/clients/README.md +++ b/distribution/clients/README.md @@ -8,7 +8,7 @@ These tools help you build an application. They do not discover nearby devices, | | Local (default) | Hosted | | --- | --- | --- | -| Runs | `npx -y @offline-protocol/cli@0.3.2 mcp serve` on your machine, over stdio | `https://mcp.offlineprotocol.com/mcp` over Streamable HTTP | +| Runs | `npx -y @offline-protocol/cli@0.3.3 mcp serve` on your machine, over stdio | `https://mcp.offlineprotocol.com/mcp` over Streamable HTTP | | Needs | Node.js 18 or later with npx. The first run downloads the pinned CLI from npm | An Offline Protocol application API key and its matching application ID. Organization keys are rejected | | Account | None | Offline Protocol developer account | | Tools | All 18 tools | Excludes `scaffold_project`, `integrate_packages` and `init_project` | @@ -73,7 +73,7 @@ cursor-agent --plugin-dir ./plugins/offline-protocol **MCP server only.** Put the contents of [`mcp-stdio.json`](mcp-stdio.json) in `.cursor/mcp.json` for one project, or in `~/.cursor/mcp.json` for all projects. If the file already exists, merge the `offline-protocol` entry into `mcpServers`. You can also open this install link in Cursor: ```text -cursor://anysphere.cursor-deeplink/mcp/install?name=offline-protocol&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBvZmZsaW5lLXByb3RvY29sL2NsaUAwLjMuMiIsIm1jcCIsInNlcnZlIl19 +cursor://anysphere.cursor-deeplink/mcp/install?name=offline-protocol&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBvZmZsaW5lLXByb3RvY29sL2NsaUAwLjMuMyIsIm1jcCIsInNlcnZlIl19 ``` Check it with the Cursor CLI (no Cursor login is needed for these two commands): @@ -108,19 +108,19 @@ VS Code reads MCP servers from `mcp.json` with a top-level `servers` object. Use Add to your user profile from a terminal: ```sh -code --add-mcp '{"name":"offline-protocol","type":"stdio","command":"npx","args":["-y","@offline-protocol/cli@0.3.2","mcp","serve"]}' +code --add-mcp '{"name":"offline-protocol","type":"stdio","command":"npx","args":["-y","@offline-protocol/cli@0.3.3","mcp","serve"]}' ``` Or open this install link, which asks VS Code to install the same server: ```text -vscode:mcp/install?%7B%22name%22%3A%22offline-protocol%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40offline-protocol%2Fcli%400.3.2%22%2C%22mcp%22%2C%22serve%22%5D%7D +vscode:mcp/install?%7B%22name%22%3A%22offline-protocol%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40offline-protocol%2Fcli%400.3.3%22%2C%22mcp%22%2C%22serve%22%5D%7D ``` On web pages where `vscode:` links are not clickable (such as GitHub READMEs), use the web redirect, which opens the same install link: ```text -https://vscode.dev/redirect/mcp/install?name=offline-protocol&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40offline-protocol%2Fcli%400.3.2%22%2C%22mcp%22%2C%22serve%22%5D%7D +https://vscode.dev/redirect/mcp/install?name=offline-protocol&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40offline-protocol%2Fcli%400.3.3%22%2C%22mcp%22%2C%22serve%22%5D%7D ``` For one workspace, copy [`vscode.json`](vscode.json) to `.vscode/mcp.json` (merge into `servers` if the file exists). Workspace servers start once you trust the workspace; user-profile servers ask for trust on first start. Run **MCP: List Servers** to start or inspect `offline-protocol`, then pick its tools in the Chat tools menu. diff --git a/distribution/clients/codex.toml b/distribution/clients/codex.toml index 2cdcb98..7495025 100644 --- a/distribution/clients/codex.toml +++ b/distribution/clients/codex.toml @@ -1,3 +1,3 @@ [mcp_servers.offline-protocol] command = "npx" -args = ["-y", "@offline-protocol/cli@0.3.2", "mcp", "serve"] +args = ["-y", "@offline-protocol/cli@0.3.3", "mcp", "serve"] diff --git a/distribution/clients/continue.yaml b/distribution/clients/continue.yaml index 9ac337a..f929721 100644 --- a/distribution/clients/continue.yaml +++ b/distribution/clients/continue.yaml @@ -1,5 +1,5 @@ name: Offline Protocol -version: 0.3.2 +version: 0.3.3 schema: v1 mcpServers: - name: Offline Protocol @@ -7,6 +7,6 @@ mcpServers: command: npx args: - "-y" - - "@offline-protocol/cli@0.3.2" + - "@offline-protocol/cli@0.3.3" - mcp - serve diff --git a/distribution/clients/devin-desktop.json b/distribution/clients/devin-desktop.json index 74c0471..ea8118a 100644 --- a/distribution/clients/devin-desktop.json +++ b/distribution/clients/devin-desktop.json @@ -4,7 +4,7 @@ "command": "npx", "args": [ "-y", - "@offline-protocol/cli@0.3.2", + "@offline-protocol/cli@0.3.3", "mcp", "serve" ] diff --git a/distribution/clients/mcp-stdio.json b/distribution/clients/mcp-stdio.json index 74c0471..ea8118a 100644 --- a/distribution/clients/mcp-stdio.json +++ b/distribution/clients/mcp-stdio.json @@ -4,7 +4,7 @@ "command": "npx", "args": [ "-y", - "@offline-protocol/cli@0.3.2", + "@offline-protocol/cli@0.3.3", "mcp", "serve" ] diff --git a/distribution/clients/priority-two.md b/distribution/clients/priority-two.md index b1b3c44..990d586 100644 --- a/distribution/clients/priority-two.md +++ b/distribution/clients/priority-two.md @@ -1,6 +1,6 @@ # Priority-two client setup -Each file here connects one client to the Offline Protocol developer MCP. Local files run `npx -y @offline-protocol/cli@0.3.2 mcp serve` and need no credentials. Hosted files use `https://mcp.offlineprotocol.com/mcp` with an application API key and the matching application id; hosted mode has no `scaffold_project`, `integrate_packages` or `init_project`. Never commit real keys. +Each file here connects one client to the Offline Protocol developer MCP. Local files run `npx -y @offline-protocol/cli@0.3.3 mcp serve` and need no credentials. Hosted files use `https://mcp.offlineprotocol.com/mcp` with an application API key and the matching application id; hosted mode has no `scaffold_project`, `integrate_packages` or `init_project`. Never commit real keys. ## Continue @@ -20,7 +20,7 @@ Each file here connects one client to the Offline Protocol developer MCP. Local - Local: `devin-desktop.json`. Hosted: `devin-desktop-hosted.json`. - The legacy Cascade agent and the Devin Local agent (default in new Devin Desktop tabs) both read `~/.config/devin/mcp_config.json` (`%APPDATA%\devin\mcp_config.json` on Windows). The Devin CLI also reads `.devin/mcp_config.json` and the gitignored `.devin/mcp_config.local.json`. - The hosted file uses `url` (accepted by Cascade, required by the Devin CLI) and `${env:...}` interpolation, which Cascade documents for `headers`. For the Devin CLI, prefer literal values in `.devin/mcp_config.local.json`. -- Devin CLI shortcut for local mode: `devin mcp add -s user offline-protocol -- npx -y @offline-protocol/cli@0.3.2 mcp serve`. +- Devin CLI shortcut for local mode: `devin mcp add -s user offline-protocol -- npx -y @offline-protocol/cli@0.3.3 mcp serve`. - Devin Local asks for approval before each MCP tool call by default. Cascade has a 100-tool limit across all servers. ## Devin (cloud) @@ -32,7 +32,7 @@ Customize, MCPs, Add custom MCP (needs the Manage MCP Servers permission): | Server name | Offline Protocol | Offline Protocol (hosted) | | Transport | STDIO | HTTP (Streamable HTTP) | | Command / URL | `npx` | `https://mcp.offlineprotocol.com/mcp` | -| Arguments | `-y @offline-protocol/cli@0.3.2 mcp serve` | | +| Arguments | `-y @offline-protocol/cli@0.3.3 mcp serve` | | | Authentication | none | Auth Header: `Authorization` = `Bearer ` | | Headers | | `x-app-id` = `` | diff --git a/distribution/clients/vscode.json b/distribution/clients/vscode.json index 83e47be..2e6076e 100644 --- a/distribution/clients/vscode.json +++ b/distribution/clients/vscode.json @@ -5,7 +5,7 @@ "command": "npx", "args": [ "-y", - "@offline-protocol/cli@0.3.2", + "@offline-protocol/cli@0.3.3", "mcp", "serve" ] diff --git a/distribution/clients/zed.json b/distribution/clients/zed.json index 069a785..f24f3c4 100644 --- a/distribution/clients/zed.json +++ b/distribution/clients/zed.json @@ -4,7 +4,7 @@ "command": "npx", "args": [ "-y", - "@offline-protocol/cli@0.3.2", + "@offline-protocol/cli@0.3.3", "mcp", "serve" ], diff --git a/distribution/cline/offline-protocol/entry.json b/distribution/cline/offline-protocol/entry.json index 86ddd49..4f690eb 100644 --- a/distribution/cline/offline-protocol/entry.json +++ b/distribution/cline/offline-protocol/entry.json @@ -25,7 +25,7 @@ "--", "npx", "-y", - "@offline-protocol/cli@0.3.2", + "@offline-protocol/cli@0.3.3", "mcp", "serve" ], diff --git a/distribution/mcp-registry/server.hosted.json b/distribution/mcp-registry/server.hosted.json index 9c2c837..8c8ae4d 100644 --- a/distribution/mcp-registry/server.hosted.json +++ b/distribution/mcp-registry/server.hosted.json @@ -7,7 +7,7 @@ "source": "github" }, "description": "Offline Protocol packages, workflows and integration guides over HTTPS. Read-only.", - "version": "0.3.2", + "version": "0.3.3", "websiteUrl": "https://www.offlineprotocol.com/docs/tools/overview", "icons": [ { diff --git a/distribution/mcp-registry/server.json b/distribution/mcp-registry/server.json index 669c5a4..68f2eb4 100644 --- a/distribution/mcp-registry/server.json +++ b/distribution/mcp-registry/server.json @@ -3,7 +3,7 @@ "name": "com.offlineprotocol/cli", "title": "Offline Protocol", "description": "Find Offline Protocol SDK packages, read integration guides, plan and scaffold local apps.", - "version": "0.3.2", + "version": "0.3.3", "websiteUrl": "https://www.offlineprotocol.com/docs/tools/overview", "repository": { "url": "https://github.com/Offline-Protocol/offline-protocol-agent-plugins", @@ -21,7 +21,7 @@ "registryType": "npm", "registryBaseUrl": "https://registry.npmjs.org", "identifier": "@offline-protocol/cli", - "version": "0.3.2", + "version": "0.3.3", "runtimeHint": "npx", "transport": { "type": "stdio" diff --git a/gemini-extension.json b/gemini-extension.json index fc404d7..4007d52 100644 --- a/gemini-extension.json +++ b/gemini-extension.json @@ -1,6 +1,6 @@ { "name": "offline-protocol", - "version": "0.1.6", + "version": "0.1.7", "description": "Build local device workflows with Offline Protocol. Find SDK packages, read integration guides, plan an implementation, and scaffold a project.", "contextFileName": "plugins/offline-protocol/skills/build-with-offline-protocol/SKILL.md", "mcpServers": { @@ -8,7 +8,7 @@ "command": "npx", "args": [ "-y", - "@offline-protocol/cli@0.3.2", + "@offline-protocol/cli@0.3.3", "mcp", "serve" ] diff --git a/plugins/offline-protocol/.claude-plugin/plugin.json b/plugins/offline-protocol/.claude-plugin/plugin.json index b6e7c2f..fb5bdfa 100644 --- a/plugins/offline-protocol/.claude-plugin/plugin.json +++ b/plugins/offline-protocol/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "offline-protocol", "displayName": "Offline Protocol", - "version": "0.1.6", + "version": "0.1.7", "description": "Build local device workflows with Offline Protocol. Find SDK packages, read integration guides, plan an implementation, and scaffold a project.", "author": { "name": "Offline Protocol", diff --git a/plugins/offline-protocol/.codex-plugin/plugin.json b/plugins/offline-protocol/.codex-plugin/plugin.json index 4b4433d..b9065e6 100644 --- a/plugins/offline-protocol/.codex-plugin/plugin.json +++ b/plugins/offline-protocol/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "offline-protocol", - "version": "0.1.6", + "version": "0.1.7", "description": "Build local device workflows with Offline Protocol. Find SDK packages, read integration guides, plan an implementation, and scaffold a project.", "author": { "name": "Offline Protocol", diff --git a/plugins/offline-protocol/.mcp.json b/plugins/offline-protocol/.mcp.json index 74c0471..ea8118a 100644 --- a/plugins/offline-protocol/.mcp.json +++ b/plugins/offline-protocol/.mcp.json @@ -4,7 +4,7 @@ "command": "npx", "args": [ "-y", - "@offline-protocol/cli@0.3.2", + "@offline-protocol/cli@0.3.3", "mcp", "serve" ] diff --git a/plugins/offline-protocol/README.md b/plugins/offline-protocol/README.md index 75810e0..d37091a 100644 --- a/plugins/offline-protocol/README.md +++ b/plugins/offline-protocol/README.md @@ -2,13 +2,13 @@ Find the SDK packages and implementation guidance for an application, plan the integration, and scaffold supported projects from your coding agent. -This package runs the published Offline Protocol CLI's local MCP server. It does not operate a device fleet or expose live device controls. Node.js 18 or later and npm/npx must be available to the client. The first run downloads the pinned CLI release (`@offline-protocol/cli@0.3.2`) from npm; no Offline Protocol account is needed for local tools. +This package runs the published Offline Protocol CLI's local MCP server. It does not operate a device fleet or expose live device controls. Node.js 18 or later and npm/npx must be available to the client. The first run downloads the pinned CLI release (`@offline-protocol/cli@0.3.3`) from npm; no Offline Protocol account is needed for local tools. ## Install - Claude Code: `claude plugin marketplace add Offline-Protocol/offline-protocol-agent-plugins`, then `claude plugin install offline-protocol@offline-protocol`. - Gemini CLI: `gemini extensions install https://github.com/Offline-Protocol/offline-protocol-agent-plugins`. -- Codex: clone the repository, run `codex plugin marketplace add ./offline-protocol-agent-plugins`, then `codex plugin add offline-protocol@offline-protocol`. Or add only the server: `codex mcp add offline-protocol -- npx -y @offline-protocol/cli@0.3.2 mcp serve`. +- Codex: clone the repository, run `codex plugin marketplace add ./offline-protocol-agent-plugins`, then `codex plugin add offline-protocol@offline-protocol`. Or add only the server: `codex mcp add offline-protocol -- npx -y @offline-protocol/cli@0.3.3 mcp serve`. - Cursor: copy this folder into `~/.cursor/plugins/local/offline-protocol` and reload Cursor. Organization policies may disable local imports. - Other MCP clients: see `distribution/clients` in this repository. @@ -18,7 +18,7 @@ Try: “Add an encrypted local handoff to this React Native app. Explain the dev ## What this plugin runs, writes and fetches -- **Runs:** `npx -y @offline-protocol/cli@0.3.2 mcp serve`, a local stdio MCP server. The first launch downloads the pinned package from the npm registry (about 47 MB unpacked, with prebuilt binaries for macOS, Linux and Windows); later launches reuse the npm cache. +- **Runs:** `npx -y @offline-protocol/cli@0.3.3 mcp serve`, a local stdio MCP server. The first launch downloads the pinned package from the npm registry (about 47 MB unpacked, with prebuilt binaries for macOS, Linux and Windows); later launches reuse the npm cache. - **Reads:** the package, workflow, template and skill registry bundled inside that CLI release. Search and read tools make no network requests and need no Offline Protocol account or key. - **Writes, only when the agent calls these tools:** `scaffold_project` creates a new project directory; `integrate_packages` edits the target project's `package.json`; `init_project` adds `offline.config.json`, adds `.mcp.json` only if none exists, and appends an Offline Protocol section to `AGENTS.md`. Use the dry-run options first and review the diff. - **Fetches, only for React Native scaffolds:** `scaffold_project` prepares native `android/` and `ios/` shells. It first looks for a cached shell in `~/.offline/cache`, and otherwise runs `npx @react-native-community/cli init` to generate it (a tarball is downloaded only when `OFFLINE_RN_SHELL_URL` is set). diff --git a/plugins/offline-protocol/mcp.json b/plugins/offline-protocol/mcp.json index f62b3d5..3a77b98 100644 --- a/plugins/offline-protocol/mcp.json +++ b/plugins/offline-protocol/mcp.json @@ -6,7 +6,7 @@ "command": "npx", "args": [ "-y", - "@offline-protocol/cli@0.3.2", + "@offline-protocol/cli@0.3.3", "mcp", "serve" ] diff --git a/plugins/offline-protocol/plugin.json b/plugins/offline-protocol/plugin.json index 61cdc5e..c0f1075 100644 --- a/plugins/offline-protocol/plugin.json +++ b/plugins/offline-protocol/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "offline-protocol", - "version": "0.1.6", + "version": "0.1.7", "description": "Build local device workflows with Offline Protocol. Find SDK packages, read integration guides, plan an implementation, and scaffold a project.", "author": { "name": "Offline Protocol", diff --git a/plugins/offline-protocol/skills/build-with-offline-protocol/SKILL.md b/plugins/offline-protocol/skills/build-with-offline-protocol/SKILL.md index 6022949..ee74a8c 100644 --- a/plugins/offline-protocol/skills/build-with-offline-protocol/SKILL.md +++ b/plugins/offline-protocol/skills/build-with-offline-protocol/SKILL.md @@ -23,7 +23,7 @@ For a new project, inspect `get_template` and `preview_scaffold` before using `s For retained events and handoffs, distinguish receipt by an SDK from persistence by the receiving application and acceptance by its backend. Design application-level event IDs, durable storage and idempotent acceptance where the workflow needs recovery. A delivered message alone does not establish that an order printed, an event reached a database, or an actuator completed an action. -The registry bundled with this CLI release pins Mesh SDK 0.32.0; telemetry in the React Native scaffolds is optional hosted upload (`enableTelemetry`) kept in `src/diagnostics.ts`, separate from networking. 0.30.0 fixed which certificates the telemetry uploader trusts, so an app that calls `enableTelemetry` on 0.26.0 to 0.29.0 should update. 0.31.0 adds the `peer_rssi` event (an exhaustive TypeScript switch over the event union needs that case), Nostr key-package lookup for a peer with no session, and self-healing of split 1:1 sessions. 0.32.0 adds service subscriptions on `MeshServices` (`subscribeService`, `publishServiceUpdate`; an exhaustive switch needs the three `service_*` event cases, and a provider must answer `service_subscribe_received` under the default policy), a C# binding preview, and Bluetooth LE that keeps discovering with the app in the background or the screen off. npm may publish newer releases. From Mesh SDK 0.28.0, Wi-Fi Direct is opt-in and forms groups between Android phones only and iPhones use a Network framework peer stream; from 0.29.0 Android also joins that slot on a shared Wi-Fi network, and otherwise an Android phone and an iPhone meet over BLE or a configured relay, so the React Native scaffolds keep `wifiDirect` disabled; read the `mesh-networking` skill before enabling it. A failed printer LAN still requires a working path to the printer, such as an existing USB-connected kitchen device. Do not promise that software replaces a missing radio or physical connection. +The registry bundled with this CLI release pins Mesh SDK 0.33.0; telemetry in the React Native scaffolds is optional hosted upload (`enableTelemetry`) kept in `src/diagnostics.ts`, separate from networking. 0.30.0 fixed which certificates the telemetry uploader trusts, so an app that calls `enableTelemetry` on 0.26.0 to 0.29.0 should update. 0.31.0 adds the `peer_rssi` event (an exhaustive TypeScript switch over the event union needs that case), Nostr key-package lookup for a peer with no session, and self-healing of split 1:1 sessions. 0.33.0 adds service subscriptions on `MeshServices` (`subscribeService`, `publishServiceUpdate`; an exhaustive switch needs the three `service_*` event cases, and a provider must answer `service_subscribe_received` under the default policy), a C# binding preview, and Bluetooth LE that keeps discovering with the app in the background or the screen off. npm may publish newer releases. From Mesh SDK 0.28.0, Wi-Fi Direct is opt-in and forms groups between Android phones only and iPhones use a Network framework peer stream; from 0.29.0 Android also joins that slot on a shared Wi-Fi network, and otherwise an Android phone and an iPhone meet over BLE or a configured relay, so the React Native scaffolds keep `wifiDirect` disabled; read the `mesh-networking` skill before enabling it. A failed printer LAN still requires a working path to the printer, such as an existing USB-connected kitchen device. Do not promise that software replaces a missing radio or physical connection. Registry samples can lag the published packages, so check SDK calls against the installed type definitions. Facts that samples written elsewhere often get wrong: Mesh SDK event payloads use snake_case fields (`message_id`, `peer_id`, `file_id`); `protocol.on()` returns the protocol, so remove listeners with `protocol.off()`; `priority` takes the `MessagePriority` enum. The CLI registry pins `@offline-protocol/id-react` 0.3.0 and `@offline-protocol/id-react-native` 0.4.0; both take `appId` on `OfflineAppProvider` (`projectId` is deprecated), and in both `sendCode` resolves to `true` and throws `OfflineIdError` (with `code`, `nextSteps`) when refused instead of resolving to `false`. Flutter has a plugin preview (`offline-protocol-flutter`, the Dart package `offline_protocol` in the SDK repository) with the React Native module's transports and native surface (`MeshSdk`) from 0.31.0: it is not on pub.dev, so the app depends on its path in a checkout of the SDK. Java on the JVM (`offline-protocol-java`, on Maven Central as `com.offlineprotocol:offline-protocol-java`, JDK 22 or later), Ruby (`offline-protocol-ruby`, the `offline_protocol` gem on RubyGems from 0.31.0, Ruby 3.3 or later) and the C API (`offline-protocol-c`, `offline_protocol.h` and the shared library from the GitHub release) leave the transports to the host and take the native library from the release's desktop archives. The browser engine (`offline-protocol-web`, experimental from 0.31.0) runs a full node in a Web Worker with WebRTC, a nearby room, Nostr and, in Chromium, Web Bluetooth; its JavaScript client is built from the SDK repository and is not on npm. Python (`offline-protocol-sdk` on PyPI) and Rust (`offline-protocol` on crates.io) cover servers and desktops; with the `http` extra the Python service also serves an HTTP front, so programs that do not use the SDK call services on other devices with plain HTTP (see the `http-front` skill). Native Swift (`offline-protocol-swift`, a Swift package) and Kotlin (`offline-protocol-android`, on Maven Central as `com.offlineprotocol:offline-protocol-sdk` from 0.29.0, minSdk 24) are early previews in which the app wires transports and storage itself and API names may change. `offline-protocol-leaf` is the protocol crate firmware teams build on for ESP32 RISC-V, Cortex-M and WASI targets, with the radio, entropy, clock and storage coming from their firmware; for a ready device, Offline Protocol's IntelligenceMesh Relay (ESP32-PICO-V3-02) relays Offline Protocol mesh traffic over Bluetooth LE. The planning tools have no starter for any of these and return that limitation instead of a plan, so tell the user rather than switching frameworks silently. `.mcp.json` files written by `init_project` or a scaffold register the same pinned npx server; when this plugin already provides the server, do not add a second copy.