Skip to main content
Almanac stores a person’s maintained understanding and ongoing work. Original services retain their own email, calendar entries and other content. An agent uses both: saved understanding supplies context, while an original can establish what was actually said or what is true now.

Understanding and its evidence

A person record is an article about someone, with structured facts and a Markdown body. An organisation, place, event, creative work, topic or general page provides a different kind of maintained understanding. Each has a stable identity and a canonical path; the path addresses a hosted record, not a local Markdown file. A source identifies an original. Registering an email thread as a source makes it a citation target; it does not turn the thread into an article or fetch its full contents. A citation connects a claim in an article to that source. The evidence lifecycle preserves this chain so a later reader can inspect the original and judge whether it still supports the saved understanding. A saved record can become stale even when its citation is valid: Sam may have changed jobs again. Read the current original when the task depends on current facts, and distinguish a past observation from a present conclusion.

Conversation and work

A session holds a conversation and its history. A task tracks an outcome and has one primary session. Tracking an existing conversation adds task metadata to that same session; it does not copy its messages into a new task conversation. A project groups related tasks and explains their shared purpose and decisions. Tasks own their own state. A project article should help someone understand the work, rather than maintain a second manually synchronized list of task statuses. Tasks and projects shows how to preserve these links. Reading a session never starts an agent. Creating a task with an initial_instruction can queue real work; creating saved state without that instruction is a different action. Conversations explains the boundary between stored history and execution.

Choose the surface that owns the answer

There is no single search command that searches all these surfaces. Following the owner prevents a summary from being mistaken for original evidence. The command map gives the direct entry points. Tasks stay open until they are done or canceled. Snooze a task to hide it from the active list until a chosen date, without changing its deadline. Snoozed tasks remain accessible in the Snoozed view. Agent activity is shown separately from the task outcome.