Skip to main content

How it fits together

You talk to the system through a few doors. Behind the doors is one small server. Behind the server are two stores: plain files for what is true, and a database for what is happening now.

You, the owneron a phone or a laptop
The doors
The OfficeChatTap-to-approve linksEmail, Discord, WhatsApp
The box one small server
Web serversdk_server.pyDraws every screen from facts.Agent alarm clockresident-wake.pyWakes agents when their time comes.Routinesroutines.json + timersJobs that run on a clock or an event.Routine pulse and Ottoroutine-pulse.pyCatch a broken job and fix it.
Agents wake, read their files, do one useful thing, write back, and choose when to wake next.
The outside worldemail, websites, the people you work with
InQuarantinemail_quarantine.pyOutside email reaches agents as a checked summary.OutSend guardsend-guard.pyMessages agents send are checked, or held for your yes.
The vaultPlain text files in gitWhat is true and how things are done: agent contracts, skills, memory, the routines list, the box code.The logbookOne database on the boxWhat is happening right now: questions, inboxes, plans, settings, spending, history.
Tap any part to read its page. Everything the box does starts from the files and rows at the bottom.

Read the map top to bottom​

  1. You open the Office on your phone, or answer a question from a link.
  2. The doors are the ways in: the Office, chat, tap-to-approve links, and messages by email, Discord, or WhatsApp. They all reach the same brain.
  3. The box is the server. Its web server draws every screen. Its alarm clock wakes agents. Its timers run routines. A checker watches that routines ran and flags any whose result it cannot verify.
  4. Two gates stand between the box and the outside world. Email comes in through the quarantine. Messages an agent sends go through the send guard. The known limits page says where these gates stop.
  5. The two stores hold everything. The vault holds what is true and how things are done. The logbook holds what is happening right now.

What powers what​

When you see...It comes from...Read
An agent's row on the OfficeRows in the logbook, and files the agent wroteThe Office
A question card from an agentAn ask row in the logbookHow an agent asks you
A red or amber health cardA check that wrote its own cardThe Health tab
"Held" on a messageThe send guardThe send guard
A job on the Every job tabThe routines list, routines.jsonRoutines and the registry
An agent's goal and limitsIts contract file, agent.md, in the vaultAn agent's files

An example day, through the map​

This is a made-up morning, but every step is how the real parts work.

  1. At 9:00 the alarm clock sees that Ada's wake time has come. It starts her.
  2. Ada reads her contract, her plan, her memory, and her inbox. A wall blocks every other action until she has read them all.
  3. A business owner replied to her invite overnight. She never sees the email itself. She sees a checked summary from the quarantine.
  4. She drafts an answer. She is not allowed to write to this person alone yet, so the send guard holds it.
  5. She asks the owner: "Send this answer to the business owner who replied?" with her reasons. The question shows up on the Office and as a link on the owner's phone.
  6. She writes what she learned, picks her next wake time, and stops.
  7. The owner taps Yes. The exact recorded send runs. The Office shows it as done.

Connected to​