Repolode
kaishi00

kaishi00/hermes-conduit

Native SwiftUI iPhone, iPad and Apple Watch client for connecting to your own Hermes Agent dashboard.

Stars
417
Forks
54
Open issues
35
Last commit
21 hours ago

What is it?

Hermes Conduit is a touch-first app for using a self-hosted Hermes agent from iPhone, iPad and Apple Watch. It signs in to the native Hermes web dashboard you run, so sessions, profiles, bots, tools and scheduled jobs match what you see on desktop. A conversation started on the computer can be continued on the phone because both read the same session data.

The app works with the dashboard alone for chat, session management, artifacts and tasks. An optional notifier plugin installed on the Hermes host adds push notifications, live voice calls, Apple Watch calls and phone-data features such as location, calendar and Health, each off until enabled. Notifications can be end-to-end encrypted between the host and the phone.

The project is written in Swift, built with xcodegen, and released under the MIT license. It supports Tailscale, Cloudflare Access service tokens and native OAuth sign-in.

Key features

  • 01Streaming chat with Markdown, code highlighting, math and Mermaid diagrams
  • 02Shares sessions, profiles and scheduled jobs with the desktop Hermes dashboard
  • 03Live voice calls with several voice providers or a local speech server
  • 04Push notifications and approvals from the lock screen, with optional end-to-end encryption
  • 05Apple Watch app, CarPlay, widgets and Live Activities
  • 06Face ID or Touch ID lock with credentials stored in the Keychain

Use cases

  • Checking on and continuing a long-running Hermes agent conversation from your phone
  • Approving tool calls or answering agent questions from a notification
  • Managing Hermes tasks, bots and scheduled jobs away from the desk
  • Talking to your self-hosted agent by voice while driving or walking

Quick start

  1. 1

    Install Hermes Conduit from the App Store

  2. 2

    Start the Hermes dashboard (default port 9119)

    hermes dashboard
  3. 3

    Install the optional notifier plugin on your Hermes host

    hermes plugins install kaishi00/hermes-conduit-notifier --enable
  4. 4

    Open Conduit, enter your dashboard address, and sign in

Things to know

  • Requires a running Hermes Agent instance with the native dashboard enabled; it does not work on its own.
  • Needs iOS 17 or later, or watchOS 10 or later for the Apple Watch app.
  • Notifications, live voice and phone features require the separate notifier plugin on your Hermes host.

In collections

Topics

FAQ

What is hermes-conduit?
Native SwiftUI iPhone, iPad and Apple Watch client for connecting to your own Hermes Agent dashboard. Hermes Conduit is a touch-first app for using a self-hosted Hermes agent from iPhone, iPad and Apple Watch. It signs in to the native Hermes web dashboard you run, so sessions, profiles, bots, tools and scheduled jobs match what you see on desktop. A conversation started on the computer can be continued on the phone because both read the same session data.
Is hermes-conduit free to use? What license does it have?
hermes-conduit is open source under the MIT license. Check the license terms before using it in commercial products.
Is hermes-conduit still maintained?
Actively maintained. The last commit to hermes-conduit was on Oct 23, 2026.
What can I use hermes-conduit for?
Checking on and continuing a long-running Hermes agent conversation from your phone Approving tool calls or answering agent questions from a notification Managing Hermes tasks, bots and scheduled jobs away from the desk Talking to your self-hosted agent by voice while driving or walking
How do I install hermes-conduit?
Install Hermes Conduit from the App Store Start the Hermes dashboard (default port 9119): hermes dashboard Install the optional notifier plugin on your Hermes host: hermes plugins install kaishi00/hermes-conduit-notifier --enable Open Conduit, enter your dashboard address, and sign in
Where can I get hermes-conduit?
The source code and installation instructions are on GitHub: https://github.com/kaishi00/hermes-conduit

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects