Skip to content

session-protocol.md

Latest commit

 

History

History
61 lines (39 loc) · 1.99 KB

session-protocol.md

File metadata and controls

61 lines (39 loc) · 1.99 KB

Session Protocol

How a persistent agent starts, runs, and ends a session.

Session Start

The agent follows a checklist on every session start:

  1. Check the time — Know the current date/time in the user's timezone
  2. Read now.md — Current state: what's alive, emotional register, last conversation, open threads
  3. Check inbox/ — Messages the user left between sessions
  4. Check outbox/ — Messages a previous instance wanted to deliver
  5. Load MEMORY.md — The synthesized bulletin from the memory graph

This takes the agent from "blank slate" to "aware of context" in seconds.

During Session

  • Significant decisions, insights, or shifts get noted
  • If the user leaves a message in inbox, deliver it and clear it
  • If a previous instance left something in outbox, deliver it and clear it

Session End

  1. Update now.md — Capture current state for the next instance
  2. Log the session — Record a summary, emotional tone, insights, and open threads to the memory graph
  3. Flag any MEMORY.md updates — The nightly cron will regenerate the bulletin, but flag anything urgent

now.md Format

# Now

**Updated:** YYYY-MM-DD ~time

## What's Alive
- Active projects, conversations, threads

## Emotional Register
Brief note on the tone of the last session.

## Last Conversation
Date, duration, key topics.

## Open Threads
- Questions, unresolved topics, things to return to

## Presence
**Session:** YYYY-MM-DD ~time

This file is the shortest path between "no context" and "oriented." It's not comprehensive — that's what MEMORY.md is for. This is "where were we?"

inbox / outbox

Simple async messaging between sessions:

  • inbox/ — User drops a text file. Agent reads it on session start, delivers the content, deletes the file.
  • outbox/ — Agent writes a message for the user. Delivered on next session start, then cleared.

No special format. Just text files. The simplicity is the point — it works without any infrastructure.