How aluro7in/forge-ai works
Forge is a collaborative project workspace where people manage project state through multiple views and AI agents can inspect or propose changes through WebMCP. The main human workflow is selecting a workspace view, editing tasks and related project artifacts, and reviewing agent proposals before they are applied. Workspace state and snapshots are managed in the React context and service layer; snapshot persistence is browser-local. The README documents further WebMCP tools and productivity features; those subsystems are represented at their supported directory paths, but their internal wiring was not sampled.
Main entry points: App.tsx Workspace shell · WorkspaceContext.tsx Workspace context · AgentPanel.tsx Agent panel · KanbanBoardView.tsx Kanban board
Components 26
Workspace UI
- Workspace shell
src/App.tsx - Navigation
src/components/Navigation.tsx - Kanban board
src/components/views/KanbanBoardView.tsx - Task list
src/components/views/TaskListView.tsx - Milestones
src/components/views/MilestonesView.tsx - Concept canvas
src/components/views/CanvasView.tsx - Documents vault
src/components/views/DocumentsView.tsx - Protocol inspector
src/components/WebMcpInspector.tsx - Workspace analytics
src/components/DashboardAnalyticsOverlay.tsx - Snapshot manager
src/components/SnapshotManagerModal.tsx
Workspace State
- Workspace context
src/context/WorkspaceContext.tsx - Workspace operations
src/services/workspaceService.ts - Snapshot storage
src/services/snapshotStorageService.ts
Agent Collaboration
- Agent panel
src/components/AgentPanel.tsx - Agent scenarios
src/agent/engine.ts - Proposal review
src/components/ProposalReviewModal.tsx
WebMCP Tools
- WebMCP context
src/webmcp/context.ts - Tool registry
src/webmcp/registry.ts - Task tools
src/webmcp/task-tools/index.ts - Planning tools
src/webmcp/planning-tools/index.ts - Project tools
src/webmcp/project-tools/index.ts - Document tools
src/webmcp/document-tools/index.ts - Canvas tools
src/webmcp/canvas-tools/index.ts - Approval tools
src/webmcp/approval-tools/index.ts
Other components
- Human teammate
- Browser AI agent
Connections 19
- Human teammate → Workspace shell: uses workspace
- Workspace shell → Navigation: renders navigation
- Workspace shell → Kanban board: renders board
- Workspace shell → Task list: renders list
- Workspace shell → Milestones: renders milestones
- Workspace shell → Concept canvas: renders canvas
- Workspace shell → Documents vault: renders documents
- Workspace shell → Protocol inspector: renders inspector
- Workspace shell → Agent panel: renders panel
- Kanban board → Workspace analytics: opens analytics
- Workspace shell → Workspace context: provides state
- Workspace context → Workspace operations: creates service
- Workspace context → Snapshot storage: loads and saves
- Snapshot manager → Workspace context: manages snapshots
- Agent panel → Agent scenarios: runs scenarios
- Agent panel → Proposal review: opens review
- Proposal review → Workspace context: applies or rejects
- Browser AI agent → WebMCP context: executes tools
- Workspace context → WebMCP context: initializes