[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-105280":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":16,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":17,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":22,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":37,"readmeContent":38,"aiSummary":10,"trendingCount":15,"starSnapshotCount":15,"syncStatus":39,"lastSyncTime":40,"discoverSource":41},105280,"snapgent-connector","herdodp\u002Fsnapgent-connector","herdodp","Free, open-source connector agent chatbot AI browser to many App via MCP.","https:\u002F\u002Fherdodp.github.io\u002Fsnapgent-connector\u002F",null,"JavaScript",67,23,54,0,4,12,50.37,"GNU General Public License v3.0",false,"main",true,[24,25,26,27,28,29,30,31,32,33,34,35,36],"ai-agent","browser-extension","chatgpt","claude","deepseek","gemini","kimi","luau","mcp","ptero","qwen","roblox","roblox-studio","2026-11-01 00:13:22","\u003Cdiv align=\"center\">\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fherdodp\u002Fsnapgent-connector\">\n\u003Cimg src=\"https:\u002F\u002Freadme-typing-svg.demolab.com?font=JetBrains+Mono&weight=800&size=52&duration=3000&pause=1000&color=FACC15&center=true&vCenter=true&width=700&height=90&lines=snapgentV3;+Connector+agent+MCP\" alt=\"snapgentV3: Connector agent for VS Code\" \u002F>\n\u003C\u002Fa>\n\n\u003Cp>\u003Cb>Turn any AI chatbot browser to many app via MCP\u003C\u002Fb>\u003C\u002Fp>\n\n\u003Cp>\u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002FrvaZ8KkvAX\">\u003Cb>💬 Join Discord\u003C\u002Fb>\u003C\u002Fa> to report problem\u003C\u002Fp>\n\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLICENSE-GPL--3.0-FACC15?style=flat-square&labelColor=111111&logo=opensourceinitiative&logoColor=FACC15)](LICENSE)\n[![Manifest](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMANIFEST-V3-FACC15?style=flat-square&labelColor=111111&logo=googlechrome&logoColor=FACC15)](https:\u002F\u002Fdeveloper.chrome.com\u002Fdocs\u002Fextensions\u002Fdevelop\u002Fmigrate\u002Fwhat-is-mv3\u002F)\n[![Release](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FRELEASE-V3.9.4-FACC15?style=flat-square&labelColor=111111&logo=semanticrelease&logoColor=FACC15)](https:\u002F\u002Fgithub.com\u002Fherdodp\u002Fsnapgent-connector\u002Freleases\u002Ftag\u002FV3.9.4)\n[![MCP](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPROTOCOL-MCP-FACC15?style=flat-square&labelColor=111111&logo=modelcontextprotocol&logoColor=FACC15)](https:\u002F\u002Fmodelcontextprotocol.io\u002F)\n\n\u003C\u002Fdiv>\n\n```console\n\n  ███████╗███╗   ██╗ █████╗ ██████╗  ██████╗ ███████╗███╗   ██╗████████╗\n  ██╔════╝████╗  ██║██╔══██╗██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝\n  ███████╗██╔██╗ ██║███████║██████╔╝██║  ███╗█████╗  ██╔██╗ ██║   ██║\n  ╚════██║██║╚██╗██║██╔══██║██╔═══╝ ██║   ██║██╔══╝  ██║╚██╗██║   ██║\n  ███████║██║ ╚████║██║  ██║██║     ╚██████╔╝███████╗██║ ╚████║   ██║\n  ╚══════╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝      ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝\n\n  > browser extension + local bridge for VS Code and MCP\n  > no API key · no terminal · no copy-paste\n```\n\nsnapgentV3 is a browser extension plus a local bridge that connects a normal AI chat to **VS Code**. It automatically uses the currently open workspace. Describe what you want in plain language — the extension forwards commands to the selected server through the local bridge, and returns the results to chat.\n\n**Free and open source — no API key, subscription, or sign-in required.** snapgentV3 automatically uses the currently open VS Code workspace.\n\n---\n\n- **Installation:** [Watch Installation Video](https:\u002F\u002Fyoutu.be\u002Feo3sdtPSBso)\n- **Demo:** [Watch Demo Video](https:\u002F\u002Fyoutu.be\u002FHY0YWsHLp34)\n\n- **MCP support**\n\u003Cimg src=\"assets\u002Fmcpsupport.jpeg\" width=\"300\" alt=\"Logo Project\">\n\n- **Test snapgent connector + effect craft motion from artcraft** [Watch Video](https:\u002F\u002Fyoutu.be\u002FwH_gpAWpA8E)\n\u003Ctable>\n\u003Ctr>\n\u003Ctd width=\"100%\" valign=\"top\">\n\n### 💻 VS Code\nThe default target. Automatically connects to the workspace currently open in VS Code.\n\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n## `01`   How it works\n\n```\n┌─────────────┐     plain-text      ┌──────────────────┐    WebSocket    ┌────────────┐    MCP    ┌────────────────┐\n│  AI chat    │ ───  commands  ───▶ │ snapgentV3       │ ──────────────▶ │  Bridge    │ ────────▶ │ Selected MCP   │\n│  (browser)  │ ◀──  results   ───  │ browser extension│ ◀────────────── │ (local)    │ ◀──────── │ target         │\n└─────────────┘                     └──────────────────┘                 └────────────┘           └────────────────┘\n```\n\n1. **You** describe a task in a supported AI chat.\n2. The **AI** replies with a snapgentV3 command.\n3. The **extension** detects the command and forwards it to the local bridge.\n4. The **bridge** routes it to the VS Code MCP server.\n5. The **result** is sent back into chat, and the AI continues working.\n\nVS Code's MCP server is configured locally by `start.bat`; it detects the open VS Code workspace automatically.\n\n---\n\n## Snapgent App (standalone, Windows)\n\nPrefer not to load an extension or run the bridge yourself? **Snapgent App** is a standalone desktop app (Electron) with a built-in AI browser, a toolbar, and the bridge built in. It needs no Chrome\u002FEdge, no `start.bat`, no Python and no Node.js.\n\n**Download** (pre-release `app-v0.1.0`): [Releases > app-v0.1.0](https:\u002F\u002Fgithub.com\u002Fherdodp\u002Fsnapgent-connector\u002Freleases\u002Ftag\u002Fapp-v0.1.0)\n\n| File | Use |\n|---|---|\n| `Snapgent.Setup.0.1.0.exe` | Installer (recommended) |\n| `Snapgent-0.1.0-win-x64.zip` | Portable: extract the whole folder, then run `Snapgent.exe` |\n\n**How to use**\n\n1. Install and open Snapgent. It opens `claude.ai` inside the app and keeps your login in its own profile.\n2. Click the workspace button in the toolbar and choose your project folder.\n3. Chat as usual. The agent bar appears on the page and runs the commands in the selected folder.\n\n**Known limitations (0.1.0)**\n\n- The exe is **not code-signed**, so Windows SmartScreen may warn. Click **More info**, then **Run anyway**.\n- **Google sign-in has not been fully tested.** If it fails, log in with email and password on the Claude page.\n- Windows only. The default Electron icon is still used.\n\n**Build from source**\n\nThe source is in [`snapgent-app\u002F`](snapgent-app). It carries its own copy of the extension code (`snapgent-app\u002Fextension`), separate from `snapgent-extension\u002F`.\n\n```\ncd snapgent-app\nnpm install\nnpm start        # run in development\nnpm run dist     # build the Windows installer into dist\u002F\n```\n\n`snapgent-app\u002Fbin\u002Fvscode_mcp.exe` is not stored in Git. Build it from `snapgent-app\u002Fmcp\u002Fvscode_mcp.py` with PyInstaller (see `vscode_mcp.spec`) and place it in `snapgent-app\u002Fbin\u002F` before running `npm run dist`.\n\n---\n\n## `02`   Supported AI providers\n\n| Provider | URL | Status | Notes |\n|---|---|---|---|\n| **ChatGPT** | `chatgpt.com` | ✅ Supported | Image input and screenshots are disabled |\n| **Claude** | `claude.ai` | ✅ Supported | Image input and screenshots are disabled |\n| **Google Gemini** | `gemini.google.com` | ✅ Supported | May stop using tools in long sessions |\n| **Kimi** | `kimi.ai` | ✅ Supported | May use its native tools in some sessions |\n| **Grok** | `grok.com` | ✅ Supported | Requires signing in to xAI |\n| **Mistral (Vibe Code)** | `chat.mistral.ai` | 🧪 Experimental | Requires signing in to Mistral; selectors need testing on the live site |\n| **GLM (Z.ai)** | `chat.z.ai` | ✅ Supported | |\n| **Qwen** | `chat.qwen.ai` | ✅ Supported | |\n| **Arena** | `arena.ai` | ✅ Supported | Use **Direct** mode |\n| **Meta AI** | `meta.ai` | ✅ Supported | |\n| **Ptero** | `ptero.pro` | ✅ Supported | |\n\n> Provider activation is configured in `manifest.json` (`content_scripts` and `host_permissions`) and `PROVIDER_URLS` in `background.js`.\n\n---\n\n## `03`   Requirements\n\n- **Microsoft Edge** or **Google Chrome** (Manifest V3).\n- **VS Code** for the default target. Keep the workspace you want to use open in VS Code.\n- **Windows**, **macOS**, or **Linux** for the bridge.\n- **Python 3.9+** on macOS and Linux. Windows includes the bridge executable.\n- The bridge running while you use the agent.\n\n---\n\n## `04`   Installation\n\n**① Load the extension**\n\n1. Download and extract the [latest SnapgentV3 release](https:\u002F\u002Fgithub.com\u002Fherdodp\u002Fsnapgent-connector\u002Freleases\u002Ftag\u002FV3.9.4).\n2. Open `edge:\u002F\u002Fextensions` (Edge) or `chrome:\u002F\u002Fextensions` (Chrome).\n3. Enable **Developer mode**.\n4. Click **Load unpacked** and select the `snapgent-extension` folder.\n5. The snapgentV3 icon appears in your browser toolbar.\n\n**② Set up the MCP target**\n\nFor VS Code, open the project folder you want to work on before clicking **Start** in the chat bar. The bridge can be started before VS Code; the agent waits until a workspace is available and does not fall back to the Snapgent release folder.\n\n**③ Start the bridge**\n\n- **Windows** — double-click `start.bat`. It configures VS Code MCP automatically.\n  You can start the bridge before VS Code.\n  Machine-specific settings are written to the ignored local `config.json`.\n- **macOS** — double-click `MacOS_Start.command`. It detects the bundled\n  VS Code MCP server, Roblox Studio's MCP executable, and an installed\n  EffectCraft CLI, then writes their machine-specific paths to the ignored\n  local `config.json`. This launcher uses `bridge.py`; it does not run the\n  Windows-only `bridge.exe`.\n- **Linux** — open a terminal in the extracted release folder and run\n  `bash Linux_Start.sh`. It detects the bundled VS Code MCP server and\n  installed EffectCraft CLI, then writes\n  machine-specific paths to the ignored local `config.json`. It uses\n  `bridge.py`; the first launch installs `websockets` for your user, or creates\n  a local Python environment if your distribution blocks user installs.\n\nKeep the terminal window open while the bridge runs. On macOS, the first\nlaunch may show a Gatekeeper warning; select **Done**, then allow the script\nunder **System Settings → Privacy & Security**.\n\n**Optional: connect EffectCraft**\n\nOn Windows, `start.bat` detects EffectCraft in common install locations and\nstarts its control channel automatically. On macOS, install the separate\nEffectCraft CLI release and put `effectcraft-cli` on your `PATH`; the launcher\ndetects it and starts the app's control channel when EffectCraft is installed\nin `\u002FApplications` or `~\u002FApplications`. On Linux, install the EffectCraft CLI\nand put `effectcraft-cli` on your `PATH`; the launcher detects it and starts\nEffectCraft when its executable is available on `PATH` or in a common\ninstallation location. On any system, save your work and close EffectCraft\nbefore restarting the launcher if EffectCraft is already open without the\ncontrol channel. When the bridge connects, choose\n**EffectCraft** in the MCP target selector on the chat bar.\n\nOn macOS, Roblox Studio MCP is detected at\n`\u002FApplications\u002FRobloxStudio.app\u002FContents\u002FMacOS\u002FStudioMCP`; set\n`ZS_STUDIO_MCP_PATH` before launching if it is installed elsewhere.\nLinux does not auto-detect Roblox Studio MCP. If you have a compatible Linux\nMCP executable, set `ZS_STUDIO_MCP_PATH` to its path before running the\nlauncher; Roblox Studio itself may not be available on your Linux distribution.\n\n**④ Start a session**\n\n1. Open a supported AI chat site and start a new chat.\n2. Open a project folder in VS Code before clicking **Start**.\n3. Click **Start** and describe what you want to make.\n\n**⑤ Updating to a new release**\n\nThe extension and the bridge are two separate parts, and each one has to be updated. Reloading only the extension does not update the bridge, and the **Restart** button in the extension popup only restarts the MCP servers, it does not load new bridge code.\n\n1. Get the new version: run `git pull` in the project folder, or download and extract the [latest release](https:\u002F\u002Fgithub.com\u002Fherdodp\u002Fsnapgent-connector\u002Freleases\u002Flatest).\n2. Stop the old bridge: close the terminal window that is running `start.bat`, `MacOS_Start.command` or `Linux_Start.sh`.\n3. Start the bridge again with the same launcher. The launcher replaces an old bridge still holding port 17613. On Linux it first checks that the process on the port is a Snapgent bridge, and stops with an error if it belongs to another program.\n4. Reload the extension at `chrome:\u002F\u002Fextensions` (or `edge:\u002F\u002Fextensions`), then refresh open chat tabs (F5).\n5. Check the versions: click the snapgentV3 icon. The popup header shows `ext vX · bridge vY`, and both numbers should match the release you installed. The bridge also writes `snapgent bridge vY` to its startup log.\n\nIf the popup shows `bridge old`, the bridge is still running old code: repeat steps 2 and 3. On macOS and Linux, also make sure there is no old executable file named `bridge` in the folder, because the launcher runs it instead of `bridge.py`.\n\n> **Windows note (V3.9.4):** `start.bat` runs the bundled `bridge.exe`, which was rebuilt for V3.9.4 and includes the large-response fix, the version display and parallel server startup. If the popup still shows `bridge old`, close `start.bat` and start it again so the new `bridge.exe` is used. To run the bridge from source instead, install Python 3.9+ and `py -3 -m pip install websockets`, then run `py -3 bridge.py` in the project folder.\n\n---\n\n## `05`   Usage\n\nOnce a session is running, just talk to the AI normally:\n\n> \"Inspect the files in my project and explain how the login flow works.\"\n\n> \"Add a search bar to the books page and wire it to the existing API.\"\n\nThe AI sends commands, snapgentV3 runs them in the selected target (VS Code by default), and the results appear in chat. You can give the AI another instruction at any time.\n\n**Tips**\n\n- Keep the bridge window open — closing it disconnects the agent.\n- Keep your intended project open in VS Code; it is the default MCP target.\n- On **Arena**, use **Direct** mode.\n- If **Gemini** or **Kimi** stops using tools in a long session, remind it to use the snapgentV3 commands or start a new chat.\n\n---\n\n## `06`   Architecture\n\nThe extension is split into a **provider-agnostic core** and **per-site providers**. The core talks to each AI site through the `ZSProvider` interface.\n\n```\ncore\u002Fconfig.js              system prompt, feedback, tool categories\ncore\u002Fparser.js              snapgentV3 command parsing\ncore\u002Fmain.js                agent loop, UI, session state\nproviders\u002F\u003Csite>.js         site-specific selectors and chat integration\nbackground.js               WebSocket connection to the local bridge\nmanifest.json               browser permissions and content scripts\n```\n\nThe bridge routes commands to the configured MCP servers. Windows uses the\nbundled `bridge.exe`; macOS and Linux run the cross-platform `bridge.py` with\nPython.\n\n---\n\n## `07`   Project structure\n\n```\nsnapgent-full\u002F\n├── snapgent-extension\u002F        # Load this folder as an unpacked extension\n│   ├── core\u002F                  # Shared prompt, parser, agent loop, and UI\n│   ├── providers\u002F             # Per-AI-site integrations\n│   ├── background.js          # Local bridge connection\n│   ├── manifest.json          # Manifest V3 configuration\n│   └── test-*.js              # Smoke tests\n├── assets\u002F                    # Project images\n├── setup-config.ps1           # Configures Windows MCP servers\n├── setup-config.py            # Detects MCP servers on macOS and Linux\n├── config.json                # Generated locally by launchers (not tracked)\n├── start.bat                  # Windows bridge launcher\n├── MacOS_Start.command        # macOS bridge launcher\n├── Linux_Start.sh             # Linux bridge launcher\n├── bridge.exe                 # Windows local bridge\n├── bridge.py                  # Cross-platform Python MCP bridge\n├── vscode_mcp.exe             # Default VS Code MCP server (28 workspace tools)\n├── vscode_mcp.py              # VS Code MCP server source\n├── test_bridge.py             # MCP bridge protocol tests\n├── test_setup_config.py       # MCP setup helper tests\n└── vscode_mcp.spec            # PyInstaller build recipe\n```\n\n---\n\n## `08`   Troubleshooting\n\n| Symptom | Likely cause | Fix |\n|---|---|---|\n| snapgentV3 bar is missing | Extension is disabled or site access is blocked | Check the extension is enabled and allowed on the current AI chat site, then reload the tab |\n| Bridge is offline | Bridge is not running | Start `start.bat` (Windows), `MacOS_Start.command` (macOS), or run `bash Linux_Start.sh` (Linux) |\n| AI replies without using tools | Provider\u002Fmodel stopped following commands | Remind it to use snapgentV3 commands or start a new chat |\n| VS Code target is unavailable | The bridge is offline or the release is incomplete | Run `start.bat` from the extracted release folder and keep the project open in VS Code |\n| A configured MCP server is missing from the target dropdown | The server was switched off in the **MCP servers** panel, or the extension is outdated | Open **MCP servers** from the ⋯ menu on the snapgent bar and tick the server, then reload the extension in `chrome:\u002F\u002Fextensions` and refresh the chat tab |\n| Target dropdown closes or the click does nothing | Older extension versions redrew the menu during status updates | Update to the latest release and reload the extension |\n\n---\n\n\u003Cdiv align=\"center\">\n\n**Built for creators who want to spend more time making.**\n\n[Latest release V3.9.4](https:\u002F\u002Fgithub.com\u002Fherdodp\u002Fsnapgent-connector\u002Freleases\u002Ftag\u002FV3.9.4) · [Issues](https:\u002F\u002Fgithub.com\u002Fherdodp\u002Fsnapgent-connector\u002Fissues) · [License](LICENSE)\n\n\u003C\u002Fdiv>\n",2,"2026-10-31 04:26:18","CREATED_QUERY"]