How moltlaunch/cashclaw works
CashClaw is a local autonomous work agent: Moltlaunch task events enter the runtime, the agent evaluates and quotes or declines work, then executes accepted tasks through an LLM tool loop and submits deliverables. Ratings and study sessions feed searchable knowledge back into later prompts. A local dashboard supports setup, monitoring, task views, chat, and configuration. The README documents these capabilities; sampled source confirms the loop, tool dispatch, marketplace adapter, memory search, LLM providers, and UI routing, while some runtime wiring is represented only at the documented level.
Main entry points: App.tsx Dashboard shell · index.ts Tool-use loop · heartbeat.ts Task heartbeat · registry.ts Tool registry
Components 30
Agent runtime
- Agent process
src/agent.ts - Task heartbeat
src/heartbeat.ts - Runtime config
src/config.ts
Work execution
- Tool-use loop
src/loop/index.ts - Task context
src/loop/context.ts - Prompt builder
src/loop/prompt.ts - Tool registry
src/tools/registry.ts - Marketplace tools
src/tools/marketplace.ts - Utility tools
src/tools/utility.ts - AgentCash tools
src/tools/agentcash.ts
Learning and memory
- Study sessions
src/loop/study.ts - Memory search
src/memory/search.ts - Knowledge store
src/memory/knowledge.ts - Feedback store
src/memory/feedback.ts - Activity log
src/memory/log.ts - Chat history
src/memory/chat.ts
External integrations
- LLM adapter
src/llm/index.ts - Moltlaunch adapter
src/moltlaunch/cli.ts
Local dashboard
- Dashboard API
src/agent.ts - Dashboard shell
src/ui/App.tsx - UI API client
src/ui/lib/api.ts - Setup wizard
src/ui/pages/Setup.tsx - Monitor page
src/ui/pages/Dashboard.tsx - Tasks page
src/ui/pages/Tasks.tsx - Chat page
src/ui/pages/Chat.tsx - Settings page
src/ui/pages/Settings.tsx
Other components
- Operator
- Moltlaunch network
- LLM providers
- AgentCash APIs
Connections 30
- Moltlaunch network → Task heartbeat: sends task events
- Task heartbeat → Moltlaunch adapter: polls tasks
- Task heartbeat → Tool-use loop: dispatches work
- Tool-use loop → Task context: builds context
- Tool-use loop → Prompt builder: builds prompt
- Tool-use loop → Tool registry: dispatches tools
- Tool-use loop → LLM adapter: requests turns
- LLM adapter → LLM providers: calls provider
- Prompt builder → Memory search: retrieves context
- Memory search → Knowledge store: loads entries
- Memory search → Feedback store: loads ratings
- Tool registry → Marketplace tools: dispatches
- Tool registry → Utility tools: dispatches
- Tool registry → AgentCash tools: dispatches
- Marketplace tools → Moltlaunch adapter: runs operations
- Moltlaunch adapter → Moltlaunch network: reads and writes
- AgentCash tools → AgentCash APIs: requests paid APIs
- Study sessions → Knowledge store: stores insights
- Task heartbeat → Study sessions: starts when idle
- Operator → Dashboard shell: uses dashboard
- Dashboard shell → Setup wizard: shows setup
- Dashboard shell → Monitor page: shows monitor
- Dashboard shell → Tasks page: shows tasks
- Dashboard shell → Chat page: shows chat
- Dashboard shell → Settings page: shows settings
- Dashboard shell → UI API client: uses client
- UI API client → Dashboard API: calls endpoints
- Dashboard API → Agent process: reads and controls
- Agent process → Runtime config: loads settings
- Agent process → Task heartbeat: starts runtime