Caduceus
dont-see-big-shark/Caduceus
Flutter native client for Hermes Agent and OpenClaw on macOS, iOS, Android and Windows
Caduceus is a cross-platform native client, written in Flutter and Dart, for driving long-running agents such as Hermes Agent and OpenClaw. It runs on macOS, iOS, Android and Windows.
What Caduceus does
Caduceus is a Flutter client that drives long-running agents such as Hermes Agent and OpenClaw from macOS, iOS, Android and Windows. The README compares it with single-platform Hermes clients, including the official Hermes Desktop app, which is desktop only, and several iOS-only, Android-only and web-only projects, and positions Caduceus as one console across all of them.
For Hermes Agent it implements the control plane through tui_gateway JSON-RPC over WebSocket plus data-plane integration, signing in with a session token or OAuth 2.0 username and password. For OpenClaw it handles gateway pairing with an Ed25519 identity handshake, session subscriptions, live reasoning streams and tool calls. A capability-gating layer covers more than 26 discrete capabilities. The design target is rendering streams of 3,000+ tokens with live tool calls and reasoning without UI hitching.
Key features
- Native Flutter app for macOS, iOS, Android and Windows
- Hermes Agent control plane over tui_gateway JSON-RPC on WebSocket, with session-token or OAuth 2.0 sign-in
- OpenClaw gateway pairing with an Ed25519 identity handshake and live reasoning and tool-call streams
- Capability gating architecture with 26+ discrete capabilities
- macOS three-column workspace with a command overlay, and an adaptive iOS phone layout with Keychain security
When to use it
- Driving a Hermes Agent from a phone and from a workstation with the same client
- Managing Hermes Agent and OpenClaw sessions from one app
- Watching live reasoning and tool calls on a Windows or macOS desktop
Who it is for: People who run Hermes Agent or OpenClaw and want a single native client across their phone and desktop machines.
How it fits with Hermes Agent
Built as a client for Hermes Agent and OpenClaw; its Hermes integration covers the tui_gateway control plane and data plane.
Note: Pi support, skill and memory synchronisation and cross-agent scheduling are still open roadmap items, and GitHub reports the license as NOASSERTION.
FAQ
What is Caduceus?
Caduceus is a native, cross-platform client for multi-agent systems such as Hermes Agent and OpenClaw. It is written in Flutter and Dart and targets macOS, iOS, Android and Windows.
Does Caduceus work with Hermes Agent?
Yes, the roadmap marks Hermes Agent support as complete, using the tui_gateway JSON-RPC control plane over WebSocket. Sign-in works with a direct session token or OAuth 2.0 username and password.
Which platforms does Caduceus support?
The roadmap marks macOS, iOS, Android and Windows as done. Windows ships as a portable ZIP, and Android was verified on versions 13 and 16.
Similar interfaces for Hermes Agent
All interfacesDesktop and web workbench where Hermes and Pi agents with distinct personalities work in one chat
SelectXn00b HermesAppAndroid app that runs a Kotlin port of the Hermes agent loop to operate apps and run commands
ASHR12 IrisDesktop voice companion that pairs Gemini Live conversation with Hermes Agent for background tasks
pyrate-llama Hermes UISingle-file glassmorphic web command center for Hermes Agent: chat, files, skills, cron and monitoring
eadmin2 J.A.R.V.I.S Voice + HUDIron-Man-style voice assistant and holographic HUD for Hermes Agent, with local Whisper speech-to-text
RedWoodOG Hermes DesktopWindows-native desktop agent built with WinUI 3 and .NET 10, using Hermes-style souls, memory and skills
Related guides: Connect Hermes agents on several machines with Hermes Desktop · How to install Hermes Agent