How cloudnutzer/tybo works
tybo is an always-on AI assistant whose main workflow accepts messages through Telegram or the browser, runs them through Claude Code with a topic-specific agent and available context, then returns replies through the chat interfaces. Persistent memory, fallback models, long-running jobs, and ongoing goals are major product capabilities. The graph uses README statements and the supplied excerpts; several subsystem connections are therefore intentionally left unspecified.
Main entry points: bot.ts Bot runtime · telegram.ts Telegram gateway · bot-turn.ts Web chat handler · memory.ts Memory and context
Components 18
Chat interfaces
- Telegram gateway
src/lib/telegram.ts - Web server
src/web/server.ts - Web chat
src/web/chat.ts - Web chat handler
src/web/bot-turn.ts
Assistant runtime
- Bot runtime
src/bot.ts
Assistant capabilities
- Agent catalog
src/agents/index.ts - Fallback models
src/lib/fallback-llm.ts - Memory and context
src/lib/memory.ts - Knowledge base
src/lib/knowledge-base.ts
Persistence
- Supabase backend
src/lib/supabase.ts - Convex client
src/lib/convex.ts - Convex data
convex/schema.ts - Session continuity
src/lib/session-manager.ts
Background work
- Goal engine
src/lib/goal-engine.ts - Background jobs
src/lib/jobs/runner.ts
Other components
- Telegram user
- Browser user
- Claude Code CLI
Connections 22
- Telegram user → Telegram gateway: sends messages
- Telegram gateway → Bot runtime: delivers messages
- Browser user → Web chat: sends messages
- Web chat → Web server: requests chat
- Web server → Web chat handler: routes turns
- Bot runtime → Agent catalog: selects agent
- Bot runtime → Claude Code CLI: runs turns
- Bot runtime → Fallback models: uses on failure
- Bot runtime → Memory and context: loads context
- Bot runtime → Knowledge base: uses knowledge
- Bot runtime → Telegram gateway: sends replies
- Web chat handler → Claude Code CLI: runs turns
- Web chat handler → Memory and context: loads context
- Web chat handler → Telegram gateway: mirrors messages
- Memory and context → Supabase backend: persists memory
- Memory and context → Convex client: persists memory
- Convex client → Convex data: reads and writes
- Bot runtime → Goal engine: checks goals
- Goal engine → Claude Code CLI: runs goal turns
- Bot runtime → Background jobs: starts jobs
- Background jobs → Telegram gateway: reports results
- Bot runtime → Session continuity: tracks sessions