How netanelrotem/agent-demo-taskboard works
The repository combines a small Todo taskboard and a FastAPI GitHub-webhook service that runs an issue-driven coding agent. The agent workflow accepts commands, coordinates planning and human input, executes repository changes, verifies them, and handles review feedback; GitHub API access, workspace management, persistence, and run events support that workflow. The Todo UI manages tasks and presentation state in a single React component. The graph reflects shown excerpts and SOURCE INDEX references; unsampled implementation details and some runtime wiring are not asserted.
Main entry points: service.py Run service · agent_graph.py Agent workflow · events.py Run events · pi_runner.py Pi runner
Components 17
Todo taskboard
- Todo interface
todo-app/src/App.tsx
Webhook ingress
- Webhook handler
coding-agent-graph/main.py - Run service
coding-agent-graph/service.py - Command parsing
coding-agent-graph/commands.py
Agent workflow
- Agent models
coding-agent-graph/agent_models.py - Agent workflow
coding-agent-graph/agent_graph.py
Execution
- Repository workspace
coding-agent-graph/workspace.py - Pi runner
coding-agent-graph/pi_runner.py - Cloud sandbox
coding-agent-graph/cloud_sandbox.py
State and integrations
- GitHub client
coding-agent-graph/github_client.py - Run storage
coding-agent-graph/storage.py - Run events
coding-agent-graph/events.py - Runtime settings
coding-agent-graph/config.py
Other components
- Taskboard user
- GitHub user
- GitHub API
- Telegram
Connections 19
- Taskboard user → Todo interface: manages tasks
todo-app/src/App.tsx - GitHub user → Webhook handler: sends commands
coding-agent-graph/main.py - Webhook handler → Run service: queues work
coding-agent-graph/main.py - Run service → Command parsing: parses commands
coding-agent-graph/main.py - Run service → Agent workflow: runs workflow
coding-agent-graph/service.py - Run service → Run storage: records runs
coding-agent-graph/service.py - Run service → Pi runner: creates runner
coding-agent-graph/service.py - Run service → Cloud sandbox: selects cloud mode
coding-agent-graph/service.py - Run service → Run events: records events
coding-agent-graph/service.py - Agent workflow → GitHub client: loads review feedback
coding-agent-graph/agent_graph.py - Agent workflow → Run storage: loads run state
coding-agent-graph/agent_graph.py - Agent workflow → Repository workspace: uses workspaces
coding-agent-graph/agent_graph.py - Agent workflow → Pi runner: runs agent
coding-agent-graph/agent_graph.py - GitHub client → GitHub API: calls API
coding-agent-graph/github_client.py - Pi runner → Run events: emits events
coding-agent-graph/pi_runner.py - Cloud sandbox → Repository workspace: extends workspace
coding-agent-graph/cloud_sandbox.py - Run events → Run storage: stores topics
coding-agent-graph/events.py - Run events → Telegram: notifies optionally
coding-agent-graph/events.py - Run service → Runtime settings: uses settings
coding-agent-graph/service.py