How imluckyluke/opencode-telegram-bot works
OpenCode Telegram Bot lets users run and monitor local OpenCode coding sessions through Telegram. The main flow is a Telegram prompt entering the bot, being sent to OpenCode with the selected session and model, and returning as streamed or formatted output. Separate documented capabilities cover session and project controls, scheduled work, attachments and voice, guest interactions, and live status. The graph preserves those product branches; links for unsampled subsystems rely on README descriptions, so their internal call paths are not asserted.
Main entry points: prompt.ts Prompt handling · event-subscription-service.ts Live event handling · client.ts OpenCode client · session-service.ts Session service
Components 22
Telegram interaction
- Bot application
src/bot/index.ts - Message routers
src/bot/routers - Prompt handling
src/bot/handlers/prompt.ts - Response rendering
src/bot/messages/assistant-rendering.ts - Telegram formatting
src/bot/render/pipeline.ts
Sessions and controls
- Session service
src/app/services/session-service.ts - Model selection
src/app/services/model-selection-service.ts - Agent selection
src/app/services/agent-selection-service.ts - Live event handling
src/bot/services/event-subscription-service.ts - Run summaries
src/app/managers/summary-aggregation-manager.ts - Pinned status
src/bot/pinned/pinned-message-manager.ts
OpenCode runtime
- OpenCode client
src/opencode/client.ts - Local OpenCode
Additional capabilities
- Scheduled tasks
src/app/services/scheduled-task-executor-service.ts - File attachments
src/app/services/attach-service.ts - Voice prompts
src/bot/handlers/voice-handler.ts - Project file browser
src/app/services/file-browser-service.ts - Guest interactions
src/bot/routers/inline-router.ts
Configuration and state
- Session state
src/app/stores/settings-store.ts - Runtime settings
src/app/stores/settings-store.ts - Localization
src/i18n/index.ts
Other components
- Telegram user
Connections 22
- Telegram user → Bot application: sends requests
README.md - Bot application → Message routers: routes updates
src/bot/index.ts - Message routers → Prompt handling: dispatches prompts
src/bot/routers/inline-router.ts - Prompt handling → Session service: uses session
src/app/services/session-service.ts - Session service → Session state: reads and updates
src/app/services/session-service.ts - Prompt handling → OpenCode client: submits coding tasks
README.md - OpenCode client → Local OpenCode: calls local API
README.md - Prompt handling → Response rendering: delivers results
README.md - Response rendering → Telegram formatting: formats output
src/bot/messages/assistant-rendering.ts - OpenCode client → Live event handling: provides session events
README.md - Live event handling → Run summaries: aggregates run activity
src/bot/services/event-subscription-service.ts - Live event handling → Pinned status: updates live status
src/bot/services/event-subscription-service.ts - Telegram user → Session service: manages sessions
README.md - Telegram user → Model selection: switches models
README.md - Telegram user → Agent selection: switches agents
README.md - Telegram user → Scheduled tasks: schedules prompts
README.md - Telegram user → File attachments: attaches files
README.md - Telegram user → Voice prompts: sends voice prompts
README.md - Telegram user → Project file browser: browses project files
README.md - Telegram user → Guest interactions: starts guest runs
README.md - Telegram user → Runtime settings: changes preferences
README.md - Runtime settings → Localization: selects locale
src/app/stores/settings-store.ts