How spectrrt/mongodb_harnesshack works
Offload is a local-first agent harness for handing off recurring and long-horizon work. A user works through the workspace; assigned Sleep tasks can be queued, executed by a durable worker, checkpointed, and reviewed with verified artifacts. The REM engine adds a day/night learning cycle that replays work, evolves harness policies, and evaluates changes. Activity history and saved-session suggestions provide additional ways to identify and draft repeatable work. The graph reflects README capabilities and shown wiring; several subsystems are represented at directory level where implementation was not sampled.
Main entry points: execution.js Task execution · index.js Local API · execution-store.js Task queue and checkpoints · execution-routes.js Sleep task routes
Components 23
Workspace app
- Workspace UI
src/pages/Workspace.jsx - Workspace state
src/store.jsx - Local API
server/index.js
Durable execution
- Sleep task routes
server/sleep/execution-routes.js - Task queue and checkpoints
server/sleep/execution-store.js - Sleep worker
server/sleep/execution-worker.js - Task execution
server/sleep/execution.js - Local tools
server/local-tools.js - Model provider
server/sleep/execution-provider.js - Task artifacts
server/sleep/execution-routes.js - Harness run store
server/harness/store.js
REM learning engine
- REM engine
rem/agent.js - Day-night cycle
rem/cycle.js - Replay and evolution
rem/night.js - World model
rem/world.js - Task checks
rem/tasks.js
Memory and activity
- Context compaction
server/context/compaction.js - Activity history
server/activity/store.js - Activity API
server/activity/routes.js
Suggestions
- Suggestion service
server/suggestions/service.js - Suggestion API
server/suggestions/routes.js
Other components
- User
- MongoDB
Connections 24
- User → Workspace UI: uses
README.md - Workspace UI → Workspace state: uses state
src/main.jsx - Workspace state → Local API: requests API
src/store.jsx - Local API → Sleep task routes: mounts routes
server/index.js - Sleep task routes → Task queue and checkpoints: queues and controls
server/sleep/execution-routes.js - Sleep task routes → Task artifacts: serves artifacts
server/sleep/execution-routes.js - Sleep worker → Task queue and checkpoints: claims tasks
server/sleep/execution-worker.js - Sleep worker → Task execution: runs task
server/sleep/execution-worker.js - Task execution → Local tools: uses tools
server/sleep/execution.js - Task execution → Task queue and checkpoints: records progress
server/sleep/execution.js - Task execution → Model provider: requests model
- Task queue and checkpoints → MongoDB: persists tasks
server/sleep/execution-store.js - Harness run store → MongoDB: persists runs
server/harness/store.js - REM engine → World model: uses world
rem/index.js - Day-night cycle → REM engine: runs harness
rem/index.js - Replay and evolution → REM engine: replays and evolves
README.md - Replay and evolution → Task checks: tests outcomes
rem/tasks.js - Local API → Activity API: mounts routes
server/index.js - Activity API → Activity history: queries history
server/activity/routes.js - Activity API → Activity history: finds friction
server/activity/routes.js - Local API → Suggestion API: mounts routes
server/index.js - Suggestion API → Suggestion service: handles requests
server/suggestions/routes.js - Suggestion service → Harness run store: runs workflows
server/suggestions/service.js - Task execution → Context compaction: compacts context
server/sleep/execution.js