From b159b7988ef1173788563c77767a7f7b129634c7 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 22 Oct 2026 20:07:45 +0000 Subject: [PATCH 1/2] Document Grok Bot and fix the Cursor local plugin install Grok Bot loads the plugin skills and the hosted MCP connector. It does not run hooks, commands, or the operator. Cursor's local loader reads plugin.json at the root of each folder under ~/.cursor/plugins/local. Clone the repo elsewhere and copy plugin/ into that folder. Team Import from Repo is unchanged. --- .../docs/get-started/agent-plugin/index.mdx | 47 ++++++++++++++++--- .../agent-plugin/whats-included.mdx | 9 ++++ 2 files changed, 50 insertions(+), 6 deletions(-) diff --git a/content/docs/get-started/agent-plugin/index.mdx b/content/docs/get-started/agent-plugin/index.mdx index 28afef6f4..787d32570 100644 --- a/content/docs/get-started/agent-plugin/index.mdx +++ b/content/docs/get-started/agent-plugin/index.mdx @@ -1,7 +1,7 @@ --- title: Install the Arcade agent plugin sidebarTitle: Install -description: Install Arcade in Cursor, Claude Code, VS Code, GitHub Copilot CLI, Codex, or Claude Desktop. Connect your agent to apps through Arcade with browser sign-in. +description: Install Arcade in Cursor, Claude Code, VS Code, GitHub Copilot CLI, Codex, Claude Desktop, or Grok Bot. Connect your agent to apps through Arcade with browser sign-in. --- import { SignupLink } from "@/components/analytics"; @@ -17,7 +17,7 @@ Install the Arcade agent plugin in a supported client and connect to its hosted -- A [supported client](/en/get-started/agent-plugin/whats-included#client-support): Cursor, Claude Code, VS Code, GitHub Copilot CLI, Codex, or Claude Desktop +- A [supported client](/en/get-started/agent-plugin/whats-included#client-support): Cursor, Claude Code, VS Code, GitHub Copilot CLI, Codex, Claude Desktop, or Grok Bot - An Arcade account - For Claude Code, Claude Cowork, Cursor CLI, GitHub Copilot CLI, and VS Code Copilot sessions: [Node.js](https://nodejs.org/) on the host's `PATH` @@ -27,7 +27,7 @@ Install the Arcade agent plugin in a supported client and connect to its hosted ## Install - + 1. Add the Arcade marketplace and install the plugin: @@ -76,10 +76,15 @@ See [Cursor's marketplace instructions](https://cursor.com/docs/plugins#add-a-te For an individual plan, or a Teams or Enterprise plan with **Allow Local Plugin Imports** enabled: -1. Clone the plugin into Cursor's local plugin directory: +Cursor loads each folder under `~/.cursor/plugins/local` as a plugin root. It looks for `plugin.json` or `.cursor-plugin/plugin.json` in that folder ([Test plugins locally](https://cursor.com/docs/plugins)). In this repository those files are `plugin/plugin.json` and `plugin/.cursor-plugin/plugin.json`. Clone the repository somewhere else, then copy `plugin/` into the local plugin folder. + +1. Clone the repository and copy the plugin folder: ```bash - git clone https://github.com/ArcadeAI/arcade-plugin ~/.cursor/plugins/local/arcade-plugin + git clone https://github.com/ArcadeAI/arcade-plugin.git ~/src/arcade-plugin + mkdir -p ~/.cursor/plugins/local + rm -rf ~/.cursor/plugins/local/arcade + cp -R ~/src/arcade-plugin/plugin ~/.cursor/plugins/local/arcade ``` 2. Run **Developer: Reload Window**. @@ -87,7 +92,14 @@ For an individual plan, or a Teams or Enterprise plan with **Allow Local Plugin 4. Connect the **arcade** MCP server and sign in to Arcade in the browser when prompted. 5. Run `/try-arcade` to start. -Keep the clone inside `~/.cursor/plugins/local/`. Cursor ignores symlinks to folders outside that directory. To update, run `git pull` in the clone and **Developer: Reload Window**. +Do not symlink to a folder outside `~/.cursor/plugins/local/`. Cursor ignores external symlink targets. To update, run `git pull` in `~/src/arcade-plugin`, copy `plugin/` over `~/.cursor/plugins/local/arcade` again, and run **Developer: Reload Window**: + +```bash +cd ~/src/arcade-plugin +git pull +rm -rf ~/.cursor/plugins/local/arcade +cp -R ~/src/arcade-plugin/plugin ~/.cursor/plugins/local/arcade +``` @@ -139,6 +151,29 @@ Use this flow for Desktop Chat and Cowork. [Installing from the Claude Code comm +Grok Bot loads the `try-arcade` and `scale-arcade` skills and the Arcade MCP server as a connector. Hooks, commands, and the `arcade-operator` subagent do not run. + +```text +https://api.arcade.dev/mcp/arcade +``` + +The connector namespace does not always use the name `arcade`. A team connector can use another name, such as `Arcade Full-Suite`. `try-arcade` calls `Arcade_SelectTools` and `Arcade_UseTool` on the namespace that exposes those tools. + +Sign in to Arcade in the browser when a task needs an app that is not connected. Each app has its own sign-in. On a Team Bot, a plugin that signs in with an account uses the person talking to the Bot. Each teammate connects their own account the first time they need it. + +Grok Bot's docs cover connecting an app, installed plugins, team connector policy, Team Bot sign-in, and authentication problems: + +- [Use the computer and apps](https://docs.x.ai/grok-bot/computer-and-apps): connect an app +- [Settings and notifications](https://docs.x.ai/grok-bot/settings-and-notifications): installed plugins +- [Grok Bot for teams and enterprises](https://docs.x.ai/grok-bot/teams-and-enterprises): team connector policy +- [Team Bots](https://docs.x.ai/grok-bot/team-bots): account sign-in on a Team Bot +- [Troubleshooting](https://docs.x.ai/grok-bot/troubleshooting): a plugin that does not install or authenticate + +Ask "What apps can Arcade use?" to start. + + + + Your client must support remote HTTP MCP servers and browser sign-in. This connection includes tools only; it does not install the plugin's skills, subagent, or commands. 1. Add an HTTP MCP server with this URL in your client's MCP settings: diff --git a/content/docs/get-started/agent-plugin/whats-included.mdx b/content/docs/get-started/agent-plugin/whats-included.mdx index aa73aebca..c6a726c82 100644 --- a/content/docs/get-started/agent-plugin/whats-included.mdx +++ b/content/docs/get-started/agent-plugin/whats-included.mdx @@ -105,9 +105,18 @@ All clients below load the Arcade MCP server and both skills. See the [plugin su No None + + + Grok Bot + + No + None + +Grok Bot loads the `try-arcade` and `scale-arcade` skills and the MCP connector at `https://api.arcade.dev/mcp/arcade`. It does not run hooks. + ## Commands Some clients namespace the commands as `/arcade:arcade-status`, `/arcade:arcade-connect`, and `/arcade:arcade-apps`. From 59edd7d9f4b88cd0709dbf3a0bd062d879188738 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 22 Oct 2026 22:04:11 +0000 Subject: [PATCH 2/2] Restore the Cursor local clone install and fix skill links arcade-plugin v0.9.0 ships a root .cursor-plugin/plugin.json, so cloning into ~/.cursor/plugins/local works again. Point try-arcade and scale-arcade at plugin/skills/. --- content/docs/get-started/agent-plugin/index.mdx | 17 ++++------------- .../get-started/agent-plugin/whats-included.mdx | 4 ++-- 2 files changed, 6 insertions(+), 15 deletions(-) diff --git a/content/docs/get-started/agent-plugin/index.mdx b/content/docs/get-started/agent-plugin/index.mdx index 787d32570..2c2afe46a 100644 --- a/content/docs/get-started/agent-plugin/index.mdx +++ b/content/docs/get-started/agent-plugin/index.mdx @@ -76,15 +76,13 @@ See [Cursor's marketplace instructions](https://cursor.com/docs/plugins#add-a-te For an individual plan, or a Teams or Enterprise plan with **Allow Local Plugin Imports** enabled: -Cursor loads each folder under `~/.cursor/plugins/local` as a plugin root. It looks for `plugin.json` or `.cursor-plugin/plugin.json` in that folder ([Test plugins locally](https://cursor.com/docs/plugins)). In this repository those files are `plugin/plugin.json` and `plugin/.cursor-plugin/plugin.json`. Clone the repository somewhere else, then copy `plugin/` into the local plugin folder. +Cursor loads each folder under `~/.cursor/plugins/local` as a plugin root. The repository's root `.cursor-plugin/plugin.json` points skills, agents, commands, rules, and the logo into `plugin/`. -1. Clone the repository and copy the plugin folder: +1. Clone the plugin into Cursor's local plugin directory: ```bash - git clone https://github.com/ArcadeAI/arcade-plugin.git ~/src/arcade-plugin mkdir -p ~/.cursor/plugins/local - rm -rf ~/.cursor/plugins/local/arcade - cp -R ~/src/arcade-plugin/plugin ~/.cursor/plugins/local/arcade + git clone https://github.com/ArcadeAI/arcade-plugin.git ~/.cursor/plugins/local/arcade-plugin ``` 2. Run **Developer: Reload Window**. @@ -92,14 +90,7 @@ Cursor loads each folder under `~/.cursor/plugins/local` as a plugin root. It lo 4. Connect the **arcade** MCP server and sign in to Arcade in the browser when prompted. 5. Run `/try-arcade` to start. -Do not symlink to a folder outside `~/.cursor/plugins/local/`. Cursor ignores external symlink targets. To update, run `git pull` in `~/src/arcade-plugin`, copy `plugin/` over `~/.cursor/plugins/local/arcade` again, and run **Developer: Reload Window**: - -```bash -cd ~/src/arcade-plugin -git pull -rm -rf ~/.cursor/plugins/local/arcade -cp -R ~/src/arcade-plugin/plugin ~/.cursor/plugins/local/arcade -``` +Keep the clone inside `~/.cursor/plugins/local/`. Cursor ignores symlinks to folders outside that directory. To update, run `git pull` in the clone and **Developer: Reload Window**. diff --git a/content/docs/get-started/agent-plugin/whats-included.mdx b/content/docs/get-started/agent-plugin/whats-included.mdx index c6a726c82..e9d890537 100644 --- a/content/docs/get-started/agent-plugin/whats-included.mdx +++ b/content/docs/get-started/agent-plugin/whats-included.mdx @@ -11,8 +11,8 @@ The plugin registers an MCP server named `arcade` at `https://api.arcade.dev/mcp ## Skills -- [`try-arcade`](https://github.com/ArcadeAI/arcade-plugin/blob/main/skills/try-arcade/SKILL.md) guides tool selection, app sign-in, and tasks across connected apps. -- [`scale-arcade`](https://github.com/ArcadeAI/arcade-plugin/blob/main/skills/scale-arcade/SKILL.md) guides gateway, tool selection, and end-user identity decisions for a proven workflow. +- [`try-arcade`](https://github.com/ArcadeAI/arcade-plugin/blob/main/plugin/skills/try-arcade/SKILL.md) guides tool selection, app sign-in, and tasks across connected apps. +- [`scale-arcade`](https://github.com/ArcadeAI/arcade-plugin/blob/main/plugin/skills/scale-arcade/SKILL.md) guides gateway, tool selection, and end-user identity decisions for a proven workflow. Skills load when relevant to your request or when called directly. How to call a skill will vary by client.