Your Hermes, one text away.
An iPhone app for Hermes Agent.
Kuya works today, and it’s in its last round of polish before it opens.
Kuya talks to your Hermes Agent, whether it runs on your own computer or on Kuya Cloud. Message it the way you would message a friend, and approve risky commands before they run.
What’s inside
Six small ideas, one app.
Each one links to the part of this page that shows it.
- Feels like texting Text your agent the way you text a friend.
- Asks before risky commands When Hermes flags a command as risky, a card asks you first.
- Pairs with one scan Open Kuya on your iPhone and point it at the screen.
- More than one Hermes Switch between servers.
- Widgets and controls New chat, dictate, or continue where you left off.
- No account and no analytics Kuya sends your chats only to the Hermes you pair it with.
Try it
Ask, then decide what runs.
Pick a message to send. The reply arrives a few words at a time, and when Hermes wants to run a risky command, Kuya asks you first. Allow it once or deny it, and the reply carries on.
Messages to send
Turn on JavaScript to try it here. The three sample chats are written out below.
Ask me anything
Read the three sample chats
Build folder
You: Clear out the build folder.
Hermes: I’ll delete the build folder so the next build starts clean.
Kuya asks first: Hermes wants to run a command. rm -rf ./build
If you allow it once: Allowed once. Done. The build folder is gone, so run the build again whenever you’re ready.
If you deny it: Action denied. Okay, I left the build folder alone. Nothing changed.
Room on the Mac
You: Make some room on my Mac.
Hermes: The biggest thing I can clear is Xcode’s old build cache. I’ll delete it.
Kuya asks first: Hermes wants to run a command. rm -rf ~/Library/Developer/Xcode/DerivedData
If you allow it once: Allowed once. Done. Xcode rebuilds what it needs the next time you open a project.
If you deny it: Action denied. Okay, I won’t touch it. Tell me if you want me to look somewhere else.
Old screenshots
You: Delete last year’s screenshots.
Hermes: I found a folder of last year’s screenshots on your Desktop. I’ll delete it.
Kuya asks first: Hermes wants to run a command. rm -rf ~/Desktop/Screenshots-2025
If you allow it once: Allowed once. Done. That folder is gone from your Desktop.
If you deny it: Action denied. Okay, the screenshots stay where they are.
The exact numbers
What it needs.
- Phone
- An iPhone on iOS 27 or later
- Hermes Agent
- 0.21.4 or newer
With its API server turned on.
The Hermes Agent project - Reaching your Hermes
- Tailscale, your home Wi-Fi or a Cloudflare Tunnel
Kuya Pair sets up Tailscale, so Kuya works away from home. Kuya Cloud needs none of these.
- Account
- None
No analytics and no ads. With your own Hermes, your chats go to it and never to us. On Kuya Cloud your agent runs on a server Hayward Labs manages, and its admin panel never shows message text.
- Widgets
- Hermes Status, Current Run, Next Task and Open Kuya
Plus the New chat, Open Kuya and Stop run controls, for Control Center and the Lock Screen.
Connect
Three ways to connect.
Kuya needs one thing from you: a Hermes to talk to. Here is how it finds yours.
Kuya Pair on a Mac
Kuya Pair is a free Mac app. It gets Hermes ready, then shows a code for your iPhone to scan.
- Download Kuya Pair on the Mac.
- Open it and follow its steps.
- Scan the code with Kuya.
A Kuya Cloud invite
Someone runs a Hermes agent for you on Kuya Cloud and emails you an invite.
- Open the invite on your iPhone.
- Tap Connect, then Open.
- Keep your recovery code.
A setup code
Someone set up Hermes for you and sent a link or a QR code.
- Tap the link on your iPhone.
- Or choose “I have a code” in Kuya.
- Paste it, or scan the QR code.
Already run Hermes yourself? Choose “I already have Hermes” in Kuya and enter its address and key.
Coming soon
Tell me when Kuya is on the App Store.
More from Hayward Labs
- Kuya CloudYour own agent, one invite away.
- MirroxYour Mac, on your Windows laptop.
- All workEvery project, where it is and where it’s going.
Hermes Agent is a project of Nous Research. Kuya is an independent app by Hayward Imagination Company and is not affiliated with or endorsed by Nous Research.
