codename-11/hermes-relay/hermes-relay-doctor

Claude Code and agent skill by codename-11/hermes-relay

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Smoke-test the Hermes-Relay bridge stack — checks relay health, phone connection, bridge channel, accessibility service, and screenshot capture in one pass

Install

npx vskill@latest install codename-11/hermes-relay/hermes-relay-doctor

SKILL.md

Hermes-Relay Doctor

Runs a sequential smoke-test of the full bridge stack and reports pass/fail with fix hints for each check. Use this before reaching for android_* tools when something feels off.

When to Use

  • User runs /hermes-relay-doctor.
  • User says the bridge isn't working, the phone isn't connecting, or a screenshot is failing.
  • You want to verify the stack is healthy before issuing android_* tool calls.
  • The android_ping() tool returns an error or phone_connected: false.

Procedure

Run the plugin CLI:

bash
hermes relay doctor        # host CLI (plugin enabled in Hermes)
hermes-relay doctor        # shell shim (installed by install.sh → plugin.cli)

If neither is available (plugin not enabled, or the hermes-relay shim was never installed), run the checks inline:

bash
PORT="${RELAY_PORT:-8767}"
curl -sf "http://127.0.0.1:$PORT/health"
curl -sf "http://127.0.0.1:$PORT/bridge/status"
curl -sf "http://127.0.0.1:$PORT/ping"
curl -sf "http://127.0.0.1:$PORT/current_app"
curl -sf "http://127.0.0.1:$PORT/screen"
curl -sf "http://127.0.0.1:$PORT/screenshot"

All six checks call loopback (127.0.0.1) — no bearer token needed.

Interpreting Results

CheckPassFail / Fix
/health{"status":"ok","version":"..."} (200)Relay not running — systemctl --user start hermes-relay or check journalctl --user -u hermes-relay -n 30
/bridge/status{"phone_connected":true,...} (200)Phone not connected — open Hermes-Relay app and scan a pairing QR (/hermes-relay-pair)
/ping{"phone_connected":true} (200)Same as above — phone disconnected mid-session; re-scan QR
/current_app{"package":"...","activity":"..."} (200)Accessibility service not connected — go to Android Settings → Accessibility → Hermes-Relay → enable
/screenJSON with nodes array (200)Same as above — also check the permission checklist in the Bridge screen
/screenshot{"token":"..."} (200)MediaProjection not granted — see "Screenshot gap" below
Screenshot gap (known issue)

/screenshot returns 500 {"error":"MediaProjection not granted — enable Bridge screenshots in the app"} when the accessibility service is running but the system MediaProjection consent dialog hasn't been accepted.

Fix:

  1. Open the Hermes-Relay app → Bridge screen.
  2. Toggle the Allow Agent Control switch on.
  3. Android shows a "Start recording?" system dialog — tap Start.
  4. Re-run /hermes-relay-doctor to confirm the screenshot check passes.

This is a per-boot requirement on Android — the MediaProjection grant is revoked on reboot.

Re-running after a fix

bash
hermes relay doctor

If the hermes-relay shim is missing, refresh it (and the rest of the install) with the idempotent updater:

bash
hermes-relay-update

Or re-run the full installer:

bash
curl -fsSL https://raw.githubusercontent.com/Codename-11/hermes-relay/main/install.sh | bash

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
197
Repository forks
44
7-day trend score
26

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/codename-11/hermes-relay/hermes-relay-doctor/badge)](https://verified-skill.com/skills/codename-11/hermes-relay/hermes-relay-doctor)

Something wrong with this skill or its page? Tell us.