01
Collect and scope
Read dated messages from local Codex or Claude Code state. Include all recent conversations or narrow to exact working directories and thread or session IDs. Passwords and keys are redacted before anything is written.
A local agent experiment · v0.4.1
A weekly letter from your AI, about you.
Your dated Codex or Claude Code conversations become a short private letter: what your agent completed, what it learned, what it stopped believing, and one question. If nothing meaningful changed, it writes nothing.
Local sources only
Per-message date window
Default silence
No fabricated metrics
The actual pipeline
Collection first, claims second.
Every sentence in a letter has to survive these three stages first.
02
Validate and gate
Turn the week into one structured summary and check it against what was actually collected: same sources, same counts, same dates. Claims without a source are rejected. A silent week is never rendered.
03
Render and archive
Write the letter, update the running ledger, and rebuild your private archive. Everything stays in one folder on your machine.
Rendered example
A weekly letter about you.
Here is a full example week. When the agent is sure it says firm, when it is less sure it says soft, and when it is new it says guess.
Trust boundary
Local does not mean invisible.
The collector's scope, the retained artifacts, and the limits of deletion are stated explicitly.
What it reads
Dated user messages and final assistant answers already stored in local Codex or Claude Code conversation history. It does not independently scan arbitrary personal files.
How scope works
The default is all dated conversations in the selected window. Use --cwd, --thread-id (Codex), or --session-id (Claude Code) to choose a smaller source set. Undated messages are excluded by default.
What is retained
The letters, their source records, and the running ledger, all under ~/sunday-letter/. Temporary transcripts are deleted after each run.
What deletion means
Delete removes Sunday Letter artifacts. It does not erase the underlying agent conversations or unrelated agent memory. Those remain controlled by Codex or Claude Code.
Install
Two supported paths, one pipeline.
Version 0.4.0 runs locally for Codex and Claude Code through the same validated pipeline. Delivery integrations come after these paths are dependable.
Clone and install
git clone https://github.com/selinayfilizp/sunday-letter.git
cd sunday-letter
./install.sh
Installs into every agent home it finds (Codex and Claude Code). Start a new session, then run /sunday-letter for a one-time letter or /subscribe-sunday-letter to configure a weekly invocation.
Claude Code users can install from the plugin marketplace instead:
/plugin marketplace add selinayfilizp/sunday-letter
/plugin install sunday-letter@sunday-letter
Codex bundle
Prefer a local import? Download the Codex bundle, built from the same tested source.
- Python standard library only
- Private local archive viewer
- Pause, Resume, Export, and Delete
Not supported yet: Cowork runtime paths, ChatGPT or Gemini installation, email or messaging delivery, remote synchronization, and cross-agent profile export.