How azhi-xinxin/tech-hub works
tech-hub is a persistent collaboration bus and task ledger for humans and AI agents. The main workflow is a person posting chat or creating work, the hub recording events, agents being notified or claiming tasks, and results returning to the shared room or task view. The single-file hub also documents attachments, approvals, folding, and a browser UI; the Android app and MCP server are optional clients, while workers provide task execution. The hub source was read but not excerpted, so internal feature links rely on README documentation; unsampled implementation details are not inferred.
Main entry points: hub.py Hub API · UnreadPollingService.kt Unread poller · HubApi.kt Android API · MainActivity.kt Android shell
Components 21
Hub service
- Hub API
hub.py - SQLite store
hub.py
Chat and inbox
- Browser UI
hub.py - Room messages
hub.py - Doorbell poll
hub.py - Attachments
hub.py - Fold history
hub.py
Task ledger
- Task ledger
hub.py - Human approvals
hub.py
Agent clients
- Codex worker
tech-hub-worker/codex_worker.py - DSH worker
dsh_worker.py - MCP adapter
tech-hub-mcp/server.py
Android app
- Android shell
tech-hub-apk/app/src/main/java/com/azhix/techhub/MainActivity.kt - Unread poller
tech-hub-apk/app/src/main/java/com/azhix/techhub/UnreadPollingService.kt - Android API
tech-hub-apk/app/src/main/java/com/azhix/techhub/HubApi.kt - Hub settings
tech-hub-apk/app/src/main/java/com/azhix/techhub/HubConfig.kt - Token vault
tech-hub-apk/app/src/main/java/com/azhix/techhub/SecureTokenStore.kt - Notifications
tech-hub-apk/app/src/main/java/com/azhix/techhub/NotificationHelper.kt - Boot receiver
tech-hub-apk/app/src/main/java/com/azhix/techhub/BootReceiver.kt
Other components
- Human
- AI agents
Connections 21
- Human → Browser UI: uses
README.md - Browser UI → Hub API: sends requests
README.md - AI agents → Hub API: uses API
README.md - Hub API → Room messages: routes chat
README.md - Hub API → Task ledger: routes tasks
README.md - Hub API → Doorbell poll: routes polls
README.md - Hub API → Attachments: routes files
README.md - Hub API → Fold history: routes folds
README.md - Hub API → Human approvals: routes approvals
README.md - Hub API → SQLite store: persists events
README.md - Codex worker → Hub API: claims and reports
- DSH worker → Hub API: claims and reports
dsh_worker.py - MCP adapter → Hub API: calls HTTP API
tech-hub-mcp/server.py - Android shell → Android API: authenticates and loads
tech-hub-apk/app/src/main/java/com/azhix/techhub/MainActivity.kt - Android shell → Unread poller: starts polling
tech-hub-apk/app/src/main/java/com/azhix/techhub/MainActivity.kt - Unread poller → Android API: fetches messages
tech-hub-apk/app/src/main/java/com/azhix/techhub/UnreadPollingService.kt - Android API → Hub API: calls HTTP API
README.md - Unread poller → Hub settings: reads and saves cursor
tech-hub-apk/app/src/main/java/com/azhix/techhub/UnreadPollingService.kt - Unread poller → Notifications: shows unread
tech-hub-apk/app/src/main/java/com/azhix/techhub/UnreadPollingService.kt - Hub settings → Token vault: stores token
tech-hub-apk/app/src/main/java/com/azhix/techhub/HubConfig.kt - Boot receiver → Unread poller: starts on boot
tech-hub-apk/app/src/main/java/com/azhix/techhub/BootReceiver.kt