How zingerlittlebee/heeler works
Heeler is a native iOS console for herdr agents. The main path is Host setup and pairing, SSH connection, live agent/event discovery, terminal attach and Composer input; supporting branches cover shell/SFTP, encrypted notifications, and Live Activities. The README documents these capabilities, but only a subset of implementation is excerpted, so undocumented internal links are omitted or marked unverified.
Main entry points: SessionDriver.swift SSH Sessions · TerminalInputController.swift Terminal Attach · pairing-session.js Key Pairing · NotificationService.swift Notification Service
Components 26
iOS Console
- Agent Console
Sources/Heeler/Console/ConsoleAgent.swift - Host Records
Sources/Heeler/Hosts/Host.swift - Host Browser
Sources/Heeler/Hosts/HostListView.swift - Herdr Transport
Sources/Heeler/Transport/Transport.swift - Event Stream
Sources/Heeler/Transport/EventsSession.swift - Terminal Attach
Sources/Heeler/Terminal/TerminalInputController.swift - Message Index
Sources/Heeler/Terminal/AttachUserMessageIndex.swift - Agent Skills
Sources/Heeler/Skills/AgentSkill.swift
SSH Access
- SSH Sessions
Packages/HeelerSSH/Sources/HeelerSSH/SessionDriver.swift - SFTP Attachments
Packages/HeelerSSH/Sources/HeelerSSH/SSHSFTPClient.swift
Pairing and Push
- Key Pairing
plugin/src/pairing-session.js - Authorized Keys
plugin/src/authorized-keys.js - Notify Hook
plugin/src/notify-hook.js - Push Relay
relay/src/worker.js - Apple Push
- Notification Service
Sources/HeelerNotificationService/NotificationService.swift - Notification Envelope
Sources/HeelerNotificationCore/NotificationEnvelope.swift - Sealed Codec
Sources/HeelerNotificationCore/SealedEnvelopeCodec.swift - Notification Keys
Sources/HeelerNotificationCore/NotificationKeyStore.swift - Notification Routing
Sources/Heeler/Notifications/AgentNotificationRouter.swift - Host Plugin
Live Activities
- Activity Envelope
Sources/HeelerActivityCore/AgentActivityEnvelope.swift - Activity Decryptor
Sources/HeelerWidgets/AgentActivityDecryptor.swift - Activity Widget
Sources/HeelerWidgets/AgentLiveActivityWidget.swift
Other components
- iOS User
- herdr Host
Connections 28
- iOS User → Host Browser: manages Hosts
README.md - Host Browser → Host Records: configures
README.md - Agent Console → Host Records: uses Host
Sources/Heeler/Console/ConsoleAgent.swift - Agent Console → Event Stream: shows updates
README.md - Event Stream → Herdr Transport: uses transport
Sources/Heeler/Transport/EventsSession.swift - Herdr Transport → SSH Sessions: opens SSH
README.md - SSH Sessions → herdr Host: connects
README.md - iOS User → Terminal Attach: steers Agent
README.md - Terminal Attach → SSH Sessions: writes PTY
README.md - Terminal Attach → Message Index: indexes drafts
Sources/Heeler/Terminal/TerminalInputController.swift - iOS User → Agent Skills: selects skills
README.md - iOS User → SFTP Attachments: stages files
README.md - SFTP Attachments → SSH Sessions: uses session
Packages/HeelerSSH/Sources/HeelerSSH/SSHSFTPClient.swift - iOS User → Key Pairing: scans code
README.md - Key Pairing → Authorized Keys: edits keys
plugin/src/pairing-session.js - Key Pairing → herdr Host: enrolls key
README.md - Host Plugin → Notify Hook: emits alerts
README.md - Notify Hook → Push Relay: forwards envelope
README.md - Push Relay → Apple Push: sends push
relay/src/worker.js - Apple Push → Notification Service: delivers push
README.md - Notification Service → Notification Keys: loads keys
Sources/HeelerNotificationService/NotificationService.swift - Notification Service → Notification Envelope: renders alert
Sources/HeelerNotificationService/NotificationService.swift - Notification Envelope → Sealed Codec: decrypts with
Sources/HeelerNotificationCore/NotificationEnvelope.swift - iOS User → Notification Routing: opens notification
README.md - Notification Routing → Agent Console: routes Agent
Sources/Heeler/Notifications/AgentNotificationRouter.swift - Activity Envelope → Sealed Codec: seals details
Sources/HeelerActivityCore/AgentActivityEnvelope.swift - Activity Decryptor → Activity Envelope: opens details
Sources/HeelerWidgets/AgentActivityDecryptor.swift - Activity Widget → Activity Decryptor: renders state
Sources/HeelerWidgets/AgentLiveActivityWidget.swift