[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BJ43S3KPR8YP6FERKMADR8":3,"skill-same:01M7BJ43S3KPR8YP6FERKMADR8":68},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":13,"repositoryHtmlUrl":44,"repositoryHomepageUrl":6,"ownerHtmlUrl":45,"ownerBlogUrl":46,"ownerDescription":6,"updatedAt":47,"install":48,"resources":61},"01M7BJ43S3KPR8YP6FERKMADR8","remote-browser-mcp",null,"Use when wiring remote Hermes to a local Mac browser MCP.","darkmatter\u002Fhermes","darkmatter","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F17834193?v=4","01M7BHSAW99WRAMTSSHNHX73V0","01M7BHSAXDR4PY4NA2DY5PN6W8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fdevbox\u002Fprofiles\u002Fplanner\u002Fskills\u002Fsoftware-development\u002Fremote-browser-mcp\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: remote-browser-mcp\ndescription: \"Use when wiring remote Hermes to a local Mac browser MCP.\"\nversion: 1.0.0\nauthor: Hermes Agent\nlicense: MIT\nplatforms: [linux, macos]\nmetadata:\n  hermes:\n    tags: [mcp, browser, vessel, tailscale, reverse-tunnel, remote]\n    category: software-development\n    related_skills: [hermes-agent, computer-use]\n---\n\n# Remote browser MCP (hub Hermes → local Mac)\n\nConnect Hermes running on a **Linux hub** (devbox) to a **browser MCP on a Mac** (Vessel, Chrome MCP, etc.) when both are on the same Tailscale tailnet.\n\n## When to use\n\n- User says browser MCP is on `:3100` \u002F Vessel \u002F local machine\n- Hermes is on remote Linux; Mac holds the real browser\n- SSH from hub → Mac fails (publickey) but Macs can dial **into** the hub\n- Need a reliable path that does not depend on hub outbound SSH\n\n## Architecture (this fleet)\n\n| Role | Host | Notes |\n|------|------|--------|\n| Hermes agent | `devbox` (`*.\u003CREDACTED>`) | Cannot reliably SSH to Macs |\n| Browser MCP | Mac (`pro` \u002F `coopers-macbook-pro` \u002F `coopers-mac-studio`) | Vessel default port **3100** |\n| Sync\u002FSSH direction | Mac → devbox | Hub-and-spoke; Macs own sessions |\n\n**Do not** default to stdio-over-SSH (`ssh mac … mcp`) from hub — that path dies on publickey unless keys are fixed. Prefer **HTTP MCP + reverse tunnel** (or Tailscale Serve).\n\n## Preferred path: reverse tunnel + HTTP MCP\n\n### 1. Confirm tunnel \u002F listener on hub\n\nOn devbox:\n\n```bash\nss -ltnp | grep 3100\n# expect: 127.0.0.1:3100 LISTEN  (often no local PID → SSH -R)\n```\n\nProbe (expect 401 without token for Vessel):\n\n```bash\ncurl -sS -m 3 -D- http:\u002F\u002F127.0.0.1:3100\u002Fmcp -o \u002Ftmp\u002Fmcp.body | head\n# Vessel: HTTP 401 {\"error\":\"Unauthorized — missing or invalid bearer \u003CREDACTED>\"}\n# Wrong path: 404 Not found\n```\n\nIf nothing listens: Mac must start the MCP **and** open the reverse forward:\n\n```bash\n# On Mac (MCP already on 127.0.0.1:3100)\nssh -N -o ExitOnForwardFailure=yes \\\n  -R 127.0.0.1:3100:127.0.0.1:3100 \\\n  cm@\u003CREDACTED>\n```\n\nDurable variant: `autossh -M 0` + `ServerAliveInterval=30`, or a LaunchAgent.\n\n### 2. Get the bearer \u003CREDACTED> (Vessel)\n\nToken lives **only on the Mac** (not in mutagen git\u002Fomp sync, not in himitsu by default):\n\n```text\n~\u002F.config\u002Fvessel\u002Fmcp-auth.json   # { \"endpoint\", \"token\", \"pid\", ... }\n```\n\nCopy to hub (from Mac):\n\n```bash\nscp ~\u002F.config\u002Fvessel\u002Fmcp-auth.json \\\n  cm@\u003CREDACTED>:\u002Fvar\u002Flib\u002Fhermes\u002F.hermes\u002Fcredentials\u002Fvessel-mcp-auth.json\n```\n\nOr have the user paste the token. Do **not** invent tokens or spray guesses.\n\n### 3. Register with Hermes\n\nHermes HTTP MCP + header auth:\n\n```bash\n# Interactive (prompts for bearer):\nhermes mcp add vessel --url http:\u002F\u002F127.0.0.1:3100\u002Fmcp --auth header\n\nhermes mcp test vessel\n# In desktop session: \u002Freload-mcp\n```\n\nConfig shape (secret in `.env`, not plaintext in yaml when using CLI header auth):\n\n```yaml\nmcp_servers:\n  vessel:\n    url: \"http:\u002F\u002F127.0.0.1:3100\u002Fmcp\"\n    headers:\n      Authorization: \u003CREDACTED>\n    timeout: 180\n    connect_timeout: 30\n```\n\nEnv key pattern: `MCP_\u003CSERVERNAME_UPPER>_TOKEN` (see Hermes `_env_key_for_server`).\n\nHelper script (if present): `~\u002F.hermes\u002Fscripts\u002Fwire-vessel-mcp.sh` — probes auth file and wires config.\n\n### 4. Verify tools\n\nAfter successful `hermes mcp test` \u002F reload, tools appear as `mcp_vessel_*` (Vessel tools are often `vessel_*` under that prefix). Exercise a cheap read-only tool (e.g. current tab) before driving navigation.\n\n## Alternate path: Tailscale Serve (no SSH -R)\n\nIf the MCP binds only loopback on the Mac:\n\n```bash\n# Mac\ntailscale serve --bg --http=3100 http:\u002F\u002F127.0.0.1:3100\n```\n\nThen from hub:\n\n```bash\nhermes mcp add vessel --url http:\u002F\u002F\u003Cmac-magicdns>:3100\u002Fmcp --auth header\n```\n\nUse MagicDNS hostnames (`pro`, `coopers-macbook-pro`, …), never LAN IPs.\n\n## Discovery checklist (do this order)\n\n1. `tailscale status` — which Macs are online\n2. Hub `ss`\u002F`curl` on `127.0.0.1:3100` — tunnel already up?\n3. If closed: probe Mac:3100 over Tailscale (`nc`\u002F`curl` to MagicDNS)\n4. Identify product by response body (Vessel → bearer \u003CREDACTED> `\u002Fmcp`)\n5. Fetch token from Mac path or user\n6. `hermes mcp add` + `test` + `\u002Freload-mcp`\n\n## Pitfalls\n\n- **Hub → Mac SSH publickey denial** — expected on this fleet until hub key is on Darwin `authorized_keys`. Do not thrash stdio-SSH; use reverse tunnel or Serve.\n- **MCP bound 127.0.0.1 only** — Tailscale direct connect fails; tunnel or Serve required.\n- **Wrong path** — Vessel is `\u002Fmcp` (streamable HTTP), not `\u002Fsse` or `\u002F`.\n- **Missing bearer** — 401 with Vessel’s exact JSON error; fix token, not network.\n- **Token not on hub** — `mcp-auth.json` is Mac-local; scp\u002Fpaste every Vessel restart if token rotates.\n- **SSH -R listener has no PID in `ss`** — normal for remote-forward sockets owned by sshd.\n- **PATH stripped in agent shells** — prefer absolute paths or `export PATH=\u002Frun\u002Fcurrent-system\u002Fsw\u002Fbin:...` on NixOS hub before `curl`\u002F`ss` pipelines.\n- **Do not store live bearer \u003CREDACTED> in skills or MEMORY.md** — credentials dir + `.env` only.\n\n## Related\n\n- Hermes native MCP reference: hermes-agent skill → `references\u002Fnative-mcp.md`\n- Desktop computer use (cua-driver) is a **different** path (stdio\u002FSSH); see `computer-use` skill\n- Session detail: `references\u002Fvessel-tailscale.md`\n","# Remote browser MCP (hub Hermes → local Mac)\n\nConnect Hermes running on a **Linux hub** (devbox) to a **browser MCP on a Mac** (Vessel, Chrome MCP, etc.) when both are on the same Tailscale tailnet.\n\n## When to use\n\n- User says browser MCP is on `:3100` \u002F Vessel \u002F local machine\n- Hermes is on remote Linux; Mac holds the real browser\n- SSH from hub → Mac fails (publickey) but Macs can dial **into** the hub\n- Need a reliable path that does not depend on hub outbound SSH\n\n## Architecture (this fleet)\n\n| Role | Host | Notes |\n|------|------|--------|\n| Hermes agent | `devbox` (`*.\u003CREDACTED>`) | Cannot reliably SSH to Macs |\n| Browser MCP | Mac (`pro` \u002F `coopers-macbook-pro` \u002F `coopers-mac-studio`) | Vessel default port **3100** |\n| Sync\u002FSSH direction | Mac → devbox | Hub-and-spoke; Macs own sessions |\n\n**Do not** default to stdio-over-SSH (`ssh mac … mcp`) from hub — that path dies on publickey unless keys are fixed. Prefer **HTTP MCP + reverse tunnel** (or Tailscale Serve).\n\n## Preferred path: reverse tunnel + HTTP MCP\n\n### 1. Confirm tunnel \u002F listener on hub\n\nOn devbox:\n\n```bash\nss -ltnp | grep 3100\n# expect: 127.0.0.1:3100 LISTEN  (often no local PID → SSH -R)\n```\n\nProbe (expect 401 without token for Vessel):\n\n```bash\ncurl -sS -m 3 -D- http:\u002F\u002F127.0.0.1:3100\u002Fmcp -o \u002Ftmp\u002Fmcp.body | head\n# Vessel: HTTP 401 {\"error\":\"Unauthorized — missing or invalid bearer \u003CREDACTED>\"}\n# Wrong path: 404 Not found\n```\n\nIf nothing listens: Mac must start the MCP **and** open the reverse forward:\n\n```bash\n# On Mac (MCP already on 127.0.0.1:3100)\nssh -N -o ExitOnForwardFailure=yes \\\n  -R 127.0.0.1:3100:127.0.0.1:3100 \\\n  cm@\u003CREDACTED>\n```\n\nDurable variant: `autossh -M 0` + `ServerAliveInterval=30`, or a LaunchAgent.\n\n### 2. Get the bearer \u003CREDACTED> (Vessel)\n\nToken lives **only on the Mac** (not in mutagen git\u002Fomp sync, not in himitsu by default):\n\n```text\n~\u002F.config\u002Fvessel\u002Fmcp-auth.json   # { \"endpoint\", \"token\", \"pid\", ... }\n```\n\nCopy to hub (from Mac):\n\n```bash\nscp ~\u002F.config\u002Fvessel\u002Fmcp-auth.json \\\n  cm@\u003CREDACTED>:\u002Fvar\u002Flib\u002Fhermes\u002F.hermes\u002Fcredentials\u002Fvessel-mcp-auth.json\n```\n\nOr have the user paste the token. Do **not** invent tokens or spray guesses.\n\n### 3. Register with Hermes\n\nHermes HTTP MCP + header auth:\n\n```bash\n# Interactive (prompts for bearer):\nhermes mcp add vessel --url http:\u002F\u002F127.0.0.1:3100\u002Fmcp --auth header\n\nhermes mcp test vessel\n# In desktop session: \u002Freload-mcp\n```\n\nConfig shape (secret in `.env`, not plaintext in yaml when using CLI header auth):\n\n```yaml\nmcp_servers:\n  vessel:\n    url: \"http:\u002F\u002F127.0.0.1:3100\u002Fmcp\"\n    headers:\n      Authorization: \u003CREDACTED>\n    timeout: 180\n    connect_timeout: 30\n```\n\nEnv key pattern: `MCP_\u003CSERVERNAME_UPPER>_TOKEN` (see Hermes `_env_key_for_server`).\n\nHelper script (if present): `~\u002F.hermes\u002Fscripts\u002Fwire-vessel-mcp.sh` — probes auth file and wires config.\n\n### 4. Verify tools\n\nAfter successful `hermes mcp test` \u002F reload, tools appear as `mcp_vessel_*` (Vessel tools are often `vessel_*` under that prefix). Exercise a cheap read-only tool (e.g. current tab) before driving navigation.\n\n## Alternate path: Tailscale Serve (no SSH -R)\n\nIf the MCP binds only loopback on the Mac:\n\n```bash\n# Mac\ntailscale serve --bg --http=3100 http:\u002F\u002F127.0.0.1:3100\n```\n\nThen from hub:\n\n```bash\nhermes mcp add vessel --url http:\u002F\u002F\u003Cmac-magicdns>:3100\u002Fmcp --auth header\n```\n\nUse MagicDNS hostnames (`pro`, `coopers-macbook-pro`, …), never LAN IPs.\n\n## Discovery checklist (do this order)\n\n1. `tailscale status` — which Macs are online\n2. Hub `ss`\u002F`curl` on `127.0.0.1:3100` — tunnel already up?\n3. If closed: probe Mac:3100 over Tailscale (`nc`\u002F`curl` to MagicDNS)\n4. Identify product by response body (Vessel → bearer \u003CREDACTED> `\u002Fmcp`)\n5. Fetch token from Mac path or user\n6. `hermes mcp add` + `test` + `\u002Freload-mcp`\n\n## Pitfalls\n\n- **Hub → Mac SSH publickey denial** — expected on this fleet until hub key is on Darwin `authorized_keys`. Do not thrash stdio-SSH; use reverse tunnel or Serve.\n- **MCP bound 127.0.0.1 only** — Tailscale direct connect fails; tunnel or Serve required.\n- **Wrong path** — Vessel is `\u002Fmcp` (streamable HTTP), not `\u002Fsse` or `\u002F`.\n- **Missing bearer** — 401 with Vessel’s exact JSON error; fix token, not network.\n- **Token not on hub** — `mcp-auth.json` is Mac-local; scp\u002Fpaste every Vessel restart if token rotates.\n- **SSH -R listener has no PID in `ss`** — normal for remote-forward sockets owned by sshd.\n- **PATH stripped in agent shells** — prefer absolute paths or `export PATH=\u002Frun\u002Fcurrent-system\u002Fsw\u002Fbin:...` on NixOS hub before `curl`\u002F`ss` pipelines.\n- **Do not store live bearer \u003CREDACTED> in skills or MEMORY.md** — credentials dir + `.env` only.\n\n## Related\n\n- Hermes native MCP reference: hermes-agent skill → `references\u002Fnative-mcp.md`\n- Desktop computer use (cua-driver) is a **different** path (stdio\u002FSSH); see `computer-use` skill\n- Session detail: `references\u002Fvessel-tailscale.md`\n",{"name":5,"author":23,"license":14,"version":24,"metadata":25,"platforms":38,"description":7},"Hermes Agent","1.0.0",{"hermes":26},{"tags":27,"category":34,"related_skills":35},[28,29,30,31,32,33],"mcp","browser","vessel","tailscale","reverse-tunnel","remote","software-development",[36,37],"hermes-agent","computer-use",[39,40],"linux","macos","main","81189f70e1089f9b3a944ffc480e6887efd831b9","devbox\u002Fprofiles\u002Fplanner\u002Fskills\u002Fsoftware-development\u002Fremote-browser-mcp","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes","https:\u002F\u002Fgithub.com\u002Fdarkmatter","dm.sh","2026-09-14 08:11:52",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add darkmatter\u002Fhermes --skill remote-browser-mcp",{"tool":54,"command":55},"bunx","bunx skills add darkmatter\u002Fhermes --skill remote-browser-mcp",{"tool":57,"command":58},"pnpm","pnpm dlx skills add darkmatter\u002Fhermes --skill remote-browser-mcp","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fdevbox\u002Fprofiles\u002Fplanner\u002Fskills\u002Fsoftware-development\u002Fremote-browser-mcp\u002FSKILL.md",true,[62],{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Fvessel-tailscale.md","REFERENCE","参考文档",2331,"https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fdevbox\u002Fprofiles\u002Fplanner\u002Fskills\u002Fsoftware-development\u002Fremote-browser-mcp\u002Freferences\u002Fvessel-tailscale.md",[69,76,83,90,97,104],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M7BMC2PYBVXM6FQEZMBQZB4G","plan","Write a markdown plan to .hermes\u002Fplans\u002F; no execution.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fplan\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":18},"01M7BMBSEKDVQ09Z666RCWT7BR","monorepo-fleet-sync","Sync docs and configs when a Flue monorepo fleet changes.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fmonorepo-fleet-sync\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":18},"01M7BMBNWFJT2TJZ2AKA64GEV9","inspecting-hermes-desktop-dom","Read the live Hermes desktop DOM\u002FCSS over CDP.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Finspecting-hermes-desktop-dom\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":18},"01M7BMAZM4VJ97K7JD0FDN58M8","grounded-citations","Ground answers and documents in cited, verifiable sources.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fgrounded-citations\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":18},"01M7BMATPEDZ4BPP67Y4ZS0BMM","competitor-news-monitor","Watch named companies for material news; cited digests.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fcompetitor-news-monitor\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":18},"01M7BMAQZV7YFA2SFPT7HCVCTX","blocked-page-recovery","Recover blocked\u002Fpaywalled\u002FWAF'd pages via fallbacks.","https:\u002F\u002Fgithub.com\u002Fdarkmatter\u002Fhermes\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fblocked-page-recovery\u002FSKILL.md",[],[]]