| THIS DOESN'T ACTUALLY WORK YET! Don't try to use it! |
GroktoDash is still in very early development.
Native macOS desktop client for Hermes Agent.
GroktoDash is a thin native SwiftUI shell around the Hermes Agent API Server.
It connects to your Hermes gateway over HTTP, using the Runs API
(/v1/runs) with SSE event streaming for real-time tool progress, approval
workflows, and rich desktop integration.
No embedded Python. No Electron. No WebKit. Pure Swift, pure macOS.
graph TB
subgraph App["GroktoDash.app (macOS 26)"]
Chat["SwiftUI Chat + Timeline"]
SSE["SSE Event Stream + Notifications"]
Kit["GroktoDashKit (framework)"]
Chat --- Kit
SSE --- Kit
end
subgraph External["External Gateway"]
API["Hermes API Server\n/v1/runs • /v1/responses • /health"]
Agent["Hermes Agent\nCLI loop + tools"]
API --- Agent
end
Kit <-->|"HTTP (Runs API)"| API
- Streaming responses — see Hermes think in real time via SSE
- Tool execution timeline — watch tools run, see results as they complete
- Approval notifications — native macOS notifications with inline Allow/Deny
- Menu bar quick-prompt — ⌘⇧Space to ask Hermes anything
- Spotlight integration — find past conversations by content
- Siri support — "Ask Hermes to review my PRs"
- Conversation persistence — SwiftData with optional iCloud sync
- Zero-trust security — App Sandbox, Hardened Runtime, Keychain storage
- macOS 26.0 (Tahoe) or later
- A running Hermes Agent instance with the API Server enabled
- Download the latest release (or build from source)
- Enter your gateway URL on first launch (e.g.
http://auriga.local:8642) - Start chatting — GroktoDash connects to your Hermes gateway
git clone https://github.com/groktopus/groktodash.git
cd groktodash
open GroktoDash.xcodeprojBuild with ⌘B, run with ⌘R.
Or from the command line:
xcodebuild -scheme GroktoDash -destination 'platform=macOS' buildMIT — see LICENSE for details.