explaingit

areu01or00/hermes-agent-mobile-client

19KotlinAudience · developerComplexity · 3/5ActiveSetup · moderate

TLDR

An Android WebView wrapper that loads the Hermes Agent dashboard from your computer so you can use the AI assistant from a phone over Tailscale or Wi-Fi.

Mindmap

mindmap
  root((Hermes-Mobile-Client))
    Inputs
      Connector URL
      Tailscale network
      Hermes server
    Outputs
      Dashboard in WebView
      Saved connection
      Terminal view
    Use Cases
      Use Hermes from phone
      Resume agent sessions
      Scan LAN for dashboard
    Tech Stack
      Android
      Kotlin
      WebView
      Tailscale

Things people build with this

USE CASE 1

Run Hermes Agent on your laptop and access it from an Android phone

USE CASE 2

Connect securely over Tailscale without exposing port 9119 to the internet

USE CASE 3

Resume a saved Hermes session from the mobile app

USE CASE 4

Scan local Wi-Fi for a running Hermes dashboard

Tech stack

AndroidKotlinWebViewNodeTailscale

Getting it running

Difficulty · moderate Time to first run · 30min

You must install Hermes Agent on a host computer and run the npx connector helper before the phone app has anything to load.

In plain English

This project is an Android app that lets you use Hermes Agent from your phone. Hermes Agent is a separate program, made by another group, that runs an AI assistant with a web dashboard on a computer or server. This repository does not change Hermes itself. It simply opens the existing Hermes dashboard inside an Android WebView, which is the part of Android that can display web pages, so you can interact with your running Hermes session from a phone. The README is careful to say what this is not. It does not reimplement Hermes sessions, chat, jobs, files, skills, or plugins. All of those still live in the original Hermes project. iOS is not supported at this point. Two pieces ship together: the Android app itself, available as a signed APK file you can download from the repo, and a small command-line helper that you run on the computer where Hermes is installed. The helper starts the Hermes dashboard with the right flags and prints a URL that you paste into the phone app. The recommended setup uses Tailscale, a service that creates a private network between devices. You install Tailscale on the phone and on the Hermes machine, sign both into the same account, then run the connector with an npx command. The connector starts the dashboard on port 9119 and gives you a URL inside the Tailscale network so port 9119 never has to be exposed to the public internet. The README notes that same Wi-Fi access works too, and a public server can work if you accept that the port will be reachable from the phone network. In the Android app there are buttons to paste a connector URL, resume the last saved connection, scan the local Wi-Fi for a Hermes dashboard, check the saved connection's status, change terminal text size, and log out. There is also a button labeled Open fresh TUI for when a session has ended. The README lists known limits. The app is only a WebView wrapper, there is no native chat interface yet. Some Hermes dashboard plugin pages are not tested on mobile. Portrait mode may clip the Hermes banner because terminal width is narrow.

Copy-paste prompts

Prompt 1
Install the Hermes mobile client APK and connect it to my laptop over Tailscale
Prompt 2
Add a native chat screen to the Android app instead of the WebView wrapper
Prompt 3
Fix the portrait-mode banner clipping in the Hermes mobile client
Prompt 4
Write a Swift port of this WebView wrapper so it runs on iOS
Prompt 5
Add a QR-code scanner that pastes the connector URL into the saved-connection field
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.