How cvsgireesh/reviewloop works
ReviewLoop is a self-hosted GitHub pull-request agent: it gathers review feedback, prepares and checks a candidate, then asks its owner in Telegram before pushing. The README documents revisions, approval invalidation when a PR changes, persistent job and preference state, and status/evidence commands. The controller excerpt supports the job, notification and publication ownership shown here; the README supplies major capabilities whose wiring was not sampled, so those links are limited to documented behavior.
Main entry points: controller.ts Workflow controller · cli.ts CLI commands · harness.ts Agent harness · github.ts PR integration
Components 19
Service and control
- CLI commands
src/cli.ts - Configuration
src/config.ts
PR workflow
- Workflow controller
src/controller.ts - PR integration
src/github.ts - Review feedback
src/skills.ts - Telegram integration
src/telegram.ts - Check evidence
src/controller.ts
Agent execution
- Agent harness
src/harness.ts - Model provider
src/model.ts - Workspace tools
src/workspace-tools.ts - Candidate workspace
src/git.ts - Patch application
src/codex-patch.ts - Isolated checks
src/sandbox.ts
State and memory
- Job and preferences
src/store.ts - Session checkpoints
src/session.ts
Other components
- PR owner
- GitHub
- AWS Bedrock
- Telegram
Connections 24
- PR owner → CLI commands: runs commands
- CLI commands → Configuration: loads settings
- CLI commands → Workflow controller: starts loop
- Workflow controller → PR integration: fetches PRs
- PR integration → GitHub: reads and pushes
- Workflow controller → Agent harness: runs job
- Agent harness → Model provider: requests completion
- Model provider → AWS Bedrock: sends prompts
- Agent harness → Workspace tools: dispatches tools
- Workspace tools → Candidate workspace: reads and edits
- Agent harness → Patch application: applies patches
- Workflow controller → Isolated checks: runs checks
- Workflow controller → Check evidence: writes results
- Workflow controller → Telegram integration: queues updates
- Telegram integration → Telegram: sends messages
- PR owner → Telegram: replies or approves
- Telegram → Workflow controller: delivers decisions
- Workflow controller → Job and preferences: saves jobs and events
- Workflow controller → Session checkpoints: checkpoints rounds
- CLI commands → Job and preferences: queries state
- CLI commands → PR owner: shows status and evidence
- Workflow controller → PR integration: rechecks before publish
- Workflow controller → GitHub: publishes approved commit
- Agent harness → Review feedback: uses review guidance