How thecodacus/pithagoras works
Pithagoras is a web portal for unattended pi coding-agent tasks. A user submits work through the portal or a configured chat channel; the server accepts it, runs the pi session independently of the browser, persists session events, and streams replayable updates back to connected clients. The map includes documented session configuration, workspaces and isolated executors, plus channel, routine, browser and voice capabilities. Some subsystem wiring is documented but not shown in the sampled excerpts, so those links are omitted where ownership is uncertain.
Main entry points: index.ts HTTP API · session-manager.ts Session manager · loader.ts Channel adapters · App.tsx Portal views
Components 23
Web client
- Portal views
web/src/App.tsx - Session chat
web/src/components/Chat.tsx
Agent runtime
- HTTP API
server/src/index.ts - Session manager
server/src/session-manager.ts - Pi client
server/src/pi/sdk-client.ts - Live event stream
server/src/live-events.ts - Session database
server/src/db.ts - Task executors
server/src/executors/index.ts
Portal capabilities
- Agent setup
server/src/agent-setup.ts - Channel supervision
server/src/channels/supervisor.ts - Routine scheduler
server/src/routines/supervisor.ts - Browser service
server/src/extensions/browser-service.ts - Voice service
server/src/extensions/voice-service.ts
External integrations
- Channel adapters
server/src/channels/loader.ts - Discord adapter
channels/discord/index.js - Slack adapter
channels/slack/index.js - Telegram adapter
channels/telegram/index.js - Webhook adapter
channels/webhook/index.js - Pi agent process
- Chat platforms
- Browser engine
- Voice engine
Other components
- Portal user
Connections 26
- Portal user → Portal views: uses
- Portal views → HTTP API: requests
- HTTP API → Session manager: manages sessions
- Session manager → Pi client: controls
- Pi client → Pi agent process: runs agent
- Session manager → Session database: persists state
- Session manager → Live event stream: records events
- Live event stream → Session chat: streams updates
- Session chat → HTTP API: submits prompts
- Session manager → Task executors: starts tasks
- HTTP API → Agent setup: serves setup
- HTTP API → Channel supervision: manages channels
- Channel supervision → Channel adapters: loads adapters
- Channel adapters → Discord adapter: loads
- Channel adapters → Slack adapter: loads
- Channel adapters → Telegram adapter: loads
- Channel adapters → Webhook adapter: loads
- Discord adapter → Chat platforms: exchanges messages
- Slack adapter → Chat platforms: exchanges messages
- Telegram adapter → Chat platforms: exchanges messages
- Webhook adapter → Session manager: submits request
- HTTP API → Routine scheduler: manages routines
- HTTP API → Browser service: serves browser controls
- Browser service → Browser engine: controls
- HTTP API → Voice service: serves voice controls
- Voice service → Voice engine: manages runtime