coder-bot

Telegram-basierter Bridge-Service für opencode AI Coding Agent.

Schnellstart

cp .env.example .env
# Edit .env with your Telegram Bot Token and other settings
docker-compose up -d

Features

Command	Beschreibung
/start	Willkommen & Hilfe
/new <name>	Neue Session erstellen
/ask <prompt>	Anfrage an die aktuelle Session
/sessions	Alle Sessions auflisten
/status <id>	Session Status
/file <path>	Dateiinhalt lesen
/abort	Laufende Aktion abbrechen
/session <id>	Zu einer Session wechseln
/clear	Aktuelle Session vergessen
/help	Hilfe anzeigen

Plain text Nachrichten werden automatisch als /ask interpretiert.

Umgebungsvariablen

Variable	Beschreibung	Standard
TELEGRAM_BOT_TOKEN	Telegram Bot Token	-
ALLOWED_CHAT_IDS	Erlaubte Chat-IDs (kommasepariert)	-
OPENCODE_SERVER_PASSWORD	Passwort für opencode Server	-
OPENCODE_API_URL	URL des opencode Servers	http://opencode-server:4096
LOG_LEVEL	Log-Level	info

Sicherheit

• Safe Mode: Shell-Befehle sind deaktiviert
• Chat-ID Whitelist: Nur autorisierte Chats können den Bot nutzen
• Rate Limiting: 1 Anfrage pro Sekunde pro Chat

Entwicklung

cd telegram-bridge
npm install
npm run dev

Test

cd telegram-bridge
npm test

Docker

docker-compose up -d

Dokumentation

Datei	Inhalt
docs/concept.md	Hauptdokumentation, Architektur
docs/architecture.md	Technische Details & Datenfluss
docs/security.md	OWASP Sicherheitskonzept
docs/api-mapping.md	Telegram ↔ Opencode API Mapping

Status

✅ Implementierung abgeschlossen - Phase 6: Tests & Dokumentation