MEMORY - Claude Auto Memory

This document contains persistent memory for Claude across sessions. Updated when patterns, conventions, or important system state changes.

Navigation: CONTENTS — full index of all notes and projects

Notes System Conventions (CRITICAL)

This system uses the MCP notes tools (notes:get, notes:put, notes:patch, notes:batch, notes:keys, notes:delete). There is no CLI. All reads and writes go through these tools directly.

When creating or updating notes, ALWAYS:

1. Read before write — call notes:get on the key first to check existing content

2. Use notes:put for new notes — pass the full JSONHTL document as the value

3. Use notes:batch for edits — get with include_block_ids=True, then batch with if_rev for safe targeted edits

4. Link from parent — IMMEDIATELY update parent page to add link to new child

5. Preserve metadata — keep version, created, title, tags, updated fields

6. Increment version — always increment version number when updating

7. Add updated date — set updated: YYYY-MM-DD when modifying

8. Preserve links — never remove links to child notes without checking

Critical reference: Avoiding Orphaned Notes and Information Loss

JSONHTL Structure Template

{
  "title": "Document Title",
  "version": 1,
  "created": "YYYY-MM-DD",
  "updated": "YYYY-MM-DD",
  "content": [
    {"heading": {"level": 1, "text": "Title"}},
    {"para": ["Text with ", {"link": {"href": "key", "text": "link"}}, " inline"]},
    {"para": ["\u2022 Bullet point"]},
    {"codeblock": {"lang": "python", "body": "code here"}}
  ]
}

Envoy System — Current State

Last Updated: 2026-04-18

Operational Status

Fully operational. Daemon mode (IMAP IDLE), hot-reload, phase-aware FSM, continuation emails, attachment delivery. For full current state see memory/envoy.

Configuration

• API key source: ~/.bashrcs/api_keys

• Daemon: /etc/rcs/envoy start|stop|restart|status

• Test account: envoy_test@critchley.biz → ~/py/envoy/responses/

• Schema: new_envoy_response_schema.json (JSON format)

• Start instructions: envoy/start (v12)

Key Documentation

• envoy — main page with all links

• envoy/changelog/2026-02-22 — phase-aware FSM, test harness

• envoy/logging — logging system

• envoy/flags-feature — flags feature

• memory/envoy — Claude Code working memory (orchestrator, bugs, testing, infra)