Skip to main content
WorkGraph is Meerkat’s durable commitment graph for agents. It answers:
  • what work exists?
  • what is blocked?
  • what is ready?
  • who claimed it?
  • what evidence supports completion?
  • what is terminally done, failed, or cancelled?
WorkGraph is realm-scoped and optional. It is not semantic memory, not schedule, and not the lightweight builtin task list.

​
Mental Model

realm
  -> namespace
  -> work items
  -> dependency edges
  -> readiness
  -> claims
  -> evidence
  -> terminal state
A WorkItem is a durable commitment. Edges describe topology such as blocks, parent, related, supersedes, and derived_from. Readiness is derived by the WorkGraph subsystem from item state, time gates, claims, and topology.

​
What WorkGraph Owns

  • item lifecycle status
  • dependency legality and graph topology
  • readiness and claimability
  • claim ownership, leases, and revision checks
  • terminal state
  • evidence references
  • event history and current-state projections
Machines and services own these semantics. Tools and host surfaces act on or observe that state; they do not reinterpret it.

​
Boundaries

NeedUse
Shared durable work, dependencies, readiness, claims, evidenceWorkGraph
One-off private scratch trackingBuiltin task_* tools
Time-based wakeups and recurrenceSchedule
Recalled knowledge and compacted contextMemory
Live collaboration messagesComms

​
Namespaces

Every item belongs to a realm and namespace. The default namespace is default, but applications can use names such as session/{id}, mob/{id}, or domain-specific namespaces. Namespaces are a scoping tool, not a promise that every group is semantically meaningful.

​
Surfaces

Agents mutate general WorkGraph items through WorkGraph tools. Host APIs, REST, and CLI expose observability so humans and UIs can inspect items, ready work, snapshots, events, goal status, and attention bindings. CLI and trusted in-process hosts additionally expose narrow session-goal attention controls; public REST/RPC remain observational for those controls.

​
See Also