How alsh007/forge-ai works
ForgeAI accepts a task and GitHub repository, runs six specialized agents in sequence, validates and may repair generated code, then reports progress and can open a pull request. The dashboard polls task and execution state through the authenticated API. The graph reflects README-documented workflow and capabilities plus the shown source references; unsampled modules are represented only where the README or source index supports their role.
Main entry points: execution.ts Execution service · src/index.ts HTTP API · src/index.ts Agent coordinator · client.ts Groq LLM client
Components 27
User experience
- Task dashboard
frontend/pages/index.tsx - Task form
frontend/components/TaskForm.tsx - Live pipeline
frontend/components/AgentPipeline.tsx - Sign-in gate
frontend/components/AuthGate.tsx - API client
frontend/lib/api.ts - Task state
frontend/lib/store.ts - Supabase client
frontend/lib/supabase.ts
API and identity
- HTTP API
backend/src/index.ts - JWT verification
backend/src/auth.ts
Task orchestration
- Execution service
backend/src/execution.ts - Cancel and timeout
backend/src/taskControl.ts
Agent generation
- Agent coordinator
agent-core/src/index.ts - Plan and design
agent-core/src/agents/base.ts - Database agent
agent-core/src/agents/base.ts - Backend and frontend agents
agent-core/src/agents/base.ts - DevOps review
agent-core/src/agents/base.ts - Static validation and repair
agent-core/src/validation/static.ts
Persistence and integrations
- Groq LLM client
agent-core/src/llm/client.ts - Repository tools
agent-core/src/llm/tools.ts - GitHub repository and PR
backend/src/github.ts - GitHub token encryption
backend/src/crypto.ts - Task and execution storage
backend/src/storage.ts
Other components
- Task submitter
- Supabase auth
- Groq API
- GitHub
- PostgreSQL
Connections 37
- Task submitter → Sign-in gate: signs in
README.md - Task submitter → Task form: submits task
README.md - Sign-in gate → Supabase client: uses auth
- Supabase client → Supabase auth: authenticates with
README.md - Task form → Task dashboard: submits values
frontend/pages/index.tsx - Task dashboard → API client: requests task data
frontend/pages/index.tsx - Task dashboard → Task state: updates task state
frontend/pages/index.tsx - Task dashboard → Live pipeline: renders progress
frontend/pages/index.tsx - API client → Supabase client: gets session token
frontend/lib/api.ts - API client → HTTP API: calls API
README.md - HTTP API → JWT verification: requires auth
backend/src/index.ts - JWT verification → Supabase auth: verifies JWT
backend/src/auth.ts - JWT verification → Task and execution storage: upserts user
backend/src/auth.ts - HTTP API → Task and execution storage: reads and writes tasks
backend/src/index.ts - HTTP API → Execution service: starts execution
backend/src/index.ts - HTTP API → Cancel and timeout: requests cancellation
backend/src/index.ts - Execution service → Cancel and timeout: registers and cancels
backend/src/execution.ts - Execution service → Task and execution storage: records progress
backend/src/execution.ts - Execution service → Agent coordinator: runs agent workflow
README.md - Execution service → GitHub repository and PR: loads repo and opens PR
backend/src/execution.ts - Execution service → GitHub token encryption: decrypts user token
backend/src/execution.ts - HTTP API → GitHub token encryption: encrypts submitted token
backend/src/index.ts - GitHub repository and PR → GitHub: reads repo and creates PR
README.md - Agent coordinator → Plan and design: runs first stages
README.md - Agent coordinator → Database agent: runs database stage
README.md - Agent coordinator → Backend and frontend agents: runs code generation
README.md - Agent coordinator → Static validation and repair: validates and repairs
agent-core/src/index.ts - Agent coordinator → DevOps review: runs final review
README.md - Plan and design → Groq LLM client: requests completion
agent-core/src/agents/base.ts - Database agent → Groq LLM client: requests generation
agent-core/src/agents/base.ts - Backend and frontend agents → Groq LLM client: requests generation
agent-core/src/agents/base.ts - DevOps review → Groq LLM client: requests review
README.md - Groq LLM client → Groq API: sends model requests
README.md - Backend and frontend agents → Repository tools: uses repository tools
agent-core/src/agents/base.ts - Repository tools → GitHub repository and PR: reads repository context
- Execution service → PostgreSQL: persists when configured
README.md - Task and execution storage → PostgreSQL: uses Prisma adapter
README.md