https://github.com/doughknee/opencode-telegram
Telegram integration tooling for OpenCode workflows and notifications.
https://github.com/doughknee/opencode-telegram
automation developer-tools opencode telegram typescript
Last synced: 20 days ago
JSON representation
Telegram integration tooling for OpenCode workflows and notifications.
- Host: GitHub
- URL: https://github.com/doughknee/opencode-telegram
- Owner: doughknee
- Created: 2026-05-02T18:02:10.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-06T12:51:03.000Z (about 2 months ago)
- Last Synced: 2026-06-06T01:18:51.751Z (27 days ago)
- Topics: automation, developer-tools, opencode, telegram, typescript
- Language: TypeScript
- Size: 955 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Headless opencode server with Telegram bridge
An always-on, self-hosted opencode AI coding agent that you can drive
from any device:
- **Laptop:** open `opencode web` in a browser over Tailscale.
- **Phone:** chat with a Telegram bot that bridges into the opencode SDK.
## What's in here
- `opencode-image/` — Docker image for the headless opencode server (LSPs + tools)
- `tg-bridge/` — TypeScript Telegram bot using `grammy` + `@opencode-ai/sdk`
- `deploy/` — Docker Compose stack
- `docs/superpowers/specs/` — design document
- `docs/superpowers/plans/` — implementation plan
## Architecture in one diagram
```
[Phone] ──Telegram──▶ [tg-bridge] ──HTTP/SSE──▶ [opencode]
[Laptop] ──Tailscale──▶ opencode web (port 4096)
(both containers run on Unraid)
```
## Quick start
See `BOOTSTRAP.md` for the one-time setup. After that:
```sh
make up-unraid # start the stack
make logs # tail logs
make down # stop
```
## Slash commands (Telegram)
- `/help` — list commands
- `/projects` — list available projects under `/workspace`
- `/switch ` — pick a project (creates a fresh session)
- `/new` — start a new session in the current project
- `/abort` — stop the current task
- `/status` — show project, session, model
- `/model [providerID/modelID]` — show or set the model
- Any other text — talk to the agent
## Development
```sh
cd tg-bridge
npm install
npm test # vitest
npm run typecheck # tsc --noEmit
npm run dev # tsx watch
```
## Design
The full design rationale and trade-offs are in
`docs/superpowers/specs/2026-05-02-headless-opencode-server-design.md`.