skills.rest
Codename-11
Codename-11COMMUNITY
Explore all skills by this author →
WebsiteGitHub

hermes-relay-self-setup

Install and manage the Hermes-Relay plugin and Android pairing pipeline on POSIX hosts.

114|20|Updated Apr 5, 2026
Search Tags:#devops#troubleshooting#android#install#pairing#hermes-agent#hermes-relay
One-click install
npx skills add https://github.com/Codename-11/hermes-relay --skill hermes-relay-self-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-relay-self-setup
Source: https://github.com/Codename-11/hermes-relay/tree/main/skills/devops/hermes-relay-self-setup
Command: npx skills add https://github.com/Codename-11/hermes-relay --skill hermes-relay-self-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a self-contained, agent-readable recipe to install, verify, update, troubleshoot, pair, and uninstall the Hermes-Relay plugin and Android pairing pipeline so users and agents can get a Hermes-Relay instance running end-to-end without manual orchestration across multiple components.

Core Features & Use Cases

  • Idempotent installation and updates: Single one-liner installer that clones or updates the repo, performs editable pip installs, regenerates shims, and optionally restarts the gateway.
  • Automated verification and health checks: Guided checks for relay health, bridge status, shims presence, plugin import, and systemd service state with clear expected outputs.
  • Pairing and recovery flows: QR and manual code pairing flows for Android clients, plus troubleshooting guidance for common failure modes like disabled bridge, missing tools, or rate limits.

Quick Start

Run the canonical installer one-liner to install or update the relay, verify health endpoints and tooling, and then run hermes-pair to complete Android pairing.

Frequently Asked Questions about hermes-relay-self-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install Hermes-Relay on Linux or macOS?▼

The Hermes-Relay installation uses a single one-liner installer on POSIX hosts to clone the repo, perform editable pip installs, regenerate shims, and optionally restart the gateway for an idempotent setup.

How do I pair an Android device with hermes-agent?▼

Android pairing with hermes-agent is completed by running the hermes-pair command, which supports both QR code and manual code pairing flows to connect your Android client to the relay.

Do I need hermes-agent already installed to set up Hermes-Relay?▼

Yes, setting up Hermes-Relay requires an existing hermes-agent installation at ~/.hermes/hermes-agent, POSIX PTY support, and internet access to fetch the installer.

Why is my Hermes-Relay Android pairing failing or not working?▼

Hermes-Relay pairing failures can stem from a disabled bridge, missing tools, or rate limits; the Skill provides troubleshooting guidance and automated health checks for relay status, shims, and systemd service state.

What's the best way to verify Hermes-Relay health and bridge status?▼

The best way to verify Hermes-Relay health is through guided automated checks for relay health, bridge status, shims presence, plugin import, and systemd service state with clear expected outputs.

Can I update or uninstall the Hermes-Relay plugin without breaking the pipeline?▼

Yes, the installer performs idempotent updates by updating the repo and regenerating shims, and dedicated uninstallation tasks allow you to safely remove the Hermes-Relay plugin and Android pairing pipeline.

Related Skills

Explore More Software Engineering Skills→
ChimeraFoundationaChimeraFoundationa

hermes-agent-spawning

Spawn Hermes Agent subprocesses for isolated long-running tasks.

Community
Advanced
Codename-11Codename-11
114

hermes-relay-pair

Generate a QR code configuring Hermes-Relay Android app and terminal relay pairing.

Community
Intermediate
Codename-11Codename-11
114

hermes-relay-doctor

Automate end-to-end health checks for the Hermes-Relay bridge stack.

Community
Advanced
datadog-labsdatadog-labs
150

agent-install

Install the Datadog Agent on Linux hosts via SSH with SSI.

Official
Intermediate