How marshupan/forme-agent works
forme is a persistent agent runtime for complex, ongoing work. Its principal loop assembles memory and context, assesses authority and risk, coordinates a route, executes through governed capabilities, verifies results, and feeds outcomes back into cognition. The repository also exposes this runtime through a web workbench and CLI, and includes installed-host worker and release management. The README establishes the end-to-end product capabilities; several internal runtime connections are not shown in the sampled source, so those relationships are left unasserted or marked unverified.
Main entry points: src/lib.rs Coordination · server.rs Web gateway · brain_tick.rs Cognition tick · src/lib.rs Governed harness
Components 25
User surfaces
- Web gateway
crates/gateway/src/server.rs - Web workbench
frontend/src/App.tsx - Workbench views
frontend/src/components/Views.tsx - Workspace view
frontend/src/components/Workspace.tsx - CLI
crates/cli/src/main.rs - Memory materials
frontend/src/memory-material.ts - Web API client
frontend/src/api/client.ts - Project routes
frontend/src/project-routes.ts
Agent runtime
- Coordination
crates/coordination/src/lib.rs - Context assembly
crates/context/src/lib.rs - Cognition tick
crates/cognition/src/brain_tick.rs - Cognitive learning
crates/cognition/src/m3_c.rs - Temporal attention
crates/cognition/src/temporal.rs
Governed execution
- Capability registry
crates/capabilities/src/registry.rs - Governed harness
crates/harness/src/lib.rs - Execution adapters
crates/execution/src/lib.rs - Model routing
crates/models/src/registry.rs
Memory and state
- Persistent memory
crates/memory/src/lib.rs - Event store
crates/store/src/at_rest.rs
Installed host
- Host HTTP service
crates/execution/src/bin/host/http.rs - Worker result routes
crates/execution/src/bin/host/worker_routes.rs - Isolated workers
crates/execution/src/installed/worker.rs - Worker protocol
crates/protocol/src/installed_product/worker.rs - Managed config files
crates/execution/src/installed/product_config/storage.rs
Other components
- Owner
Connections 23
- Owner → Web workbench: uses workbench
- Owner → CLI: uses CLI
- Web workbench → Web API client: requests data
frontend/src/App.tsx - Web API client → Web gateway: calls endpoints
- Web gateway → Workbench views: serves workbench
- Workbench views → Memory materials: renders material
- Workspace view → Project routes: shows project routes
- Web gateway → Coordination: serves runtime
- CLI → Coordination: composes runtime
- Coordination → Context assembly: assembles context
- Coordination → Cognition tick: chooses next work
- Cognition tick → Temporal attention: manages attention
- Cognition tick → Cognitive learning: learns from evidence
- Coordination → Capability registry: selects capabilities
- Coordination → Governed harness: governs execution
- Governed harness → Execution adapters: dispatches work
- Governed harness → Model routing: routes models
- Cognitive learning → Persistent memory: updates memory
- Persistent memory → Event store: persists history
- Host HTTP service → Worker result routes: routes requests
crates/execution/src/bin/host/http.rs - Worker result routes → Isolated workers: reads results
crates/execution/src/bin/host/worker_routes.rs - Isolated workers → Worker protocol: checks permits
- Managed config files → Event store: stores configuration