How deviousdevv303/forgeclaw works
ForgeClaw is an operator-controlled AI development and automation console. The main workflow starts in the browser workspace: a user submits a request, the app routes it to a configured provider, and any requested side effects run through ForgeTools and Guardian before results and failures are surfaced. The product also supports GitHub and Pages operations, live research, image input, self-sculpt pull requests, browser automation, and NEXUS learning. The README documents these capabilities; sampled source confirms key App, router, and orchestration links, while some subsystem internals were not sampled.
Main entry points: forgeTools.ts ForgeTools · App.tsx Browser workspace · useOrchestrator.ts Task orchestration · providerRouter.ts Provider router
Components 25
Operator workspace
- Browser workspace
src/App.tsx - Workspace panels
src/components/AgentsPanel.tsx
Agent runtime
- Task orchestration
src/hooks/useOrchestrator.ts - Provider router
src/lib/ai/providerRouter.ts - Provider adapters
src/lib/ai/providers/anthropicProvider.ts - Image input
src/lib/imageInput.ts
Tools and integrations
- ForgeTools
src/lib/forgeTools.ts - GitHub operations
src/lib/github.ts - Remote shell
src/lib/shellCommand.ts - Pages publishing
src/lib/siteBuild.ts - Web research
src/lib/deepResearch.ts - Browser automation
src/lib/browserAgent.ts - Self-sculpt workflow
src/lib/sculptCommand.ts
Safety and observability
- Autonomy policy
src/core/autonomyEngine.ts - Integrity validation
src/hooks/useIntegrityGate.ts - Guardian gate
src/lib/guardianGate.ts - Failure dashboard
src/components/FailureDashboard.tsx - Browser storage
src/lib/storage.ts
NEXUS learning
- Learning events
src/lib/learningEvents.ts - Evidence corpus
src/lib/corpus.ts - NEXUS convergence
src/lib/nexusConvergence.ts
Other components
- Operator
- Configured AI services
- GitHub Actions runners
- Live web
Connections 26
- Operator → Browser workspace: submits request
- Browser workspace → Provider router: routes turn
src/App.tsx - Provider router → Provider adapters: dispatches provider
src/lib/ai/providerRouter.ts - Provider adapters → Configured AI services: requests inference
- Provider router → Image input: processes image input
src/lib/ai/providerRouter.ts - Browser workspace → ForgeTools: executes tool
src/App.tsx - Browser workspace → Task orchestration: coordinates agents
src/App.tsx - Task orchestration → Autonomy policy: evaluates admission
src/hooks/useOrchestrator.ts - Task orchestration → Integrity validation: validates output
src/hooks/useOrchestrator.ts - ForgeTools → Guardian gate: checks side effects
- ForgeTools → GitHub operations: performs repository work
- ForgeTools → Remote shell: dispatches command
- ForgeTools → Pages publishing: publishes site
- ForgeTools → Web research: runs research
- ForgeTools → Browser automation: starts automation
- ForgeTools → Self-sculpt workflow: opens review PR
- GitHub operations → GitHub Actions runners: dispatches workflows
- Web research → Live web: searches and fetches
- Browser automation → GitHub Actions runners: runs automation
- Browser workspace → Failure dashboard: surfaces failures
src/App.tsx - Task orchestration → Failure dashboard: emits failure events
src/hooks/useOrchestrator.ts - Browser workspace → Workspace panels: renders workspace panels
src/App.tsx - Learning events → Evidence corpus: records outcomes
src/lib/learningEvents.ts - NEXUS convergence → Evidence corpus: converges evidence
- Browser workspace → Browser storage: persists workspace state
src/App.tsx - Autonomy policy → Browser storage: persists decision ledger