Concepts

Native authorities

One honest source of truth per concern, connected without shadow state.

AgentOS composes standard systems and leaves each one authoritative:

ConcernAuthority
Human planning and interventionCaptain-selected tracker and provider workflow
Fleet identity, Tasks, Assignments, Inbox and decisionsPostgreSQL
Running workloads and effective RBACKubernetes
Native terminal and harness sessionHerdr
Agent home, unfinished work and private memoryPVC
Delivered source and review artifactGit and its provider

No single row or dashboard can truthfully replace all of them. PostgreSQL may say an Assignment is active while Kubernetes says its Pod is gone; that disagreement is a recovery condition, not a reason to overwrite either source.

Connect, do not mirror

Provider intent can be reconciled into durable Fleet work without copying the provider’s entire world into PostgreSQL. A targeted wake can tell an Agent to query its Inbox without placing the message body in the notification. A pull request can close the delivery loop without storing Git history in a universal event table.

This boundary keeps the company inspectable and replaceable. Use psql, kubectl, Herdr, Git and provider tools through their native interfaces.

Last updated on

On this page