Claude-Mem

        sequenceDiagram
          participant You as You
          participant CC as Claude Code
          participant H as Hooks
          participant W as Worker
          participant O as Observer AI

          Note over You,O: SESSION START
          H->>W: SessionStart hook
          W-->>CC: "No previous sessions found"

          You->>CC: "Build a signup page with email validation"
          H->>W: UserPromptSubmit
          W->>O: Spawn observer

          CC->>CC: Read src/app/layout.tsx
          H->>W: PostToolUse (Read)
          W->>O: Feed event

          CC->>CC: Write src/app/signup/page.tsx
          H->>W: PostToolUse (Write)
          W->>O: Feed event
          Note over O: Observation: FEATURE
"Created signup page component
with form and email input"

          CC->>CC: Write src/lib/validators.ts
          H->>W: PostToolUse (Write)
          W->>O: Feed event
          Note over O: Observation: DECISION
"Used Zod for email validation
over regex for type safety"

          CC->>CC: Run npm test (fails)
          H->>W: PostToolUse (Bash)
          W->>O: Feed event

          CC->>CC: Edit src/lib/validators.ts
          H->>W: PostToolUse (Edit)
          W->>O: Feed event
          Note over O: Observation: BUGFIX
"Fixed Zod schema - email()
must come before min()"

          CC->>CC: Run npm test (passes)
          H->>W: PostToolUse (Bash)

          Note over You,O: SESSION END
          H->>W: Stop hook
          W->>O: Request summary
          O-->>W: Session summary XML
          W->>W: Store 3 observations + 1 summary
      

        sequenceDiagram
          participant U as Your Claude Session
          participant H as Hook Layer
          participant W as Worker :37777
          participant O as Observer Agent
          participant DB as SQLite + Chroma

          U->>H: User sends prompt
          H->>W: POST /sessions/init
          W->>O: Spawn SDK subprocess
          Note over O: Separate Claude instance
watching your session

          U->>U: Uses Read tool
          H->>W: POST /sessions/observations
          W->>O: Feed tool event
          O->>O: Analyze + generate XML

          U->>U: Uses Edit tool
          H->>W: POST /sessions/observations
          W->>O: Feed tool event
          O-->>W: XML observation response
          W->>DB: Store observation

          U->>U: Session ends
          H->>W: POST /sessions/summarize
          W->>O: Request summary
          O-->>W: XML summary
          W->>DB: Store summary
      

        graph TD
          A["New Session Starts"] --> B["SessionStart Hook"]
          B --> C["ContextBuilder"]
          C --> D["Load Recent Observations"]
          D --> E["Calculate Token Economics"]
          E --> F["Inject Context into Session"]

          F --> G["User Sends Prompt"]
          G --> H["UserPromptSubmit Hook"]
          H --> I["Create Session Record"]
          I --> J["Spawn SDK Observer"]

          F --> K["Tool Executes"]
          K --> L["PostToolUse Hook"]
          L --> M["Strip Privacy Tags"]
          M --> N["Feed to Observer"]
          N --> O["Observer Generates XML"]
          O --> P["Parse Observations"]
          P --> Q{"Deduplicate"}
          Q -->|"New"| R["Save to SQLite"]
          R --> S["Sync to Chroma"]
          Q -->|"Duplicate"| T["Skip"]

          F --> U["Session Ends"]
          U --> V["Stop Hook"]
          V --> W["Generate Summary"]
          W --> X["Store Summary"]
          X --> Y["Mark Session Complete"]
          Y --> Z["Ready for Next Session"]

          classDef start fill:#a78bfa22,stroke:#a78bfa,stroke-width:2px
          classDef hook fill:#22d3ee22,stroke:#22d3ee,stroke-width:2px
          classDef ai fill:#34d39922,stroke:#34d399,stroke-width:2px
          classDef storage fill:#818cf822,stroke:#818cf8,stroke-width:2px
          classDef end fill:#fbbf2422,stroke:#fbbf24,stroke-width:2px
          classDef skip fill:#fb718522,stroke:#fb7185,stroke-width:1.5px

          class A,G,F start
          class B,H,L,V hook
          class C,D,E,J,N,O,P,W ai
          class I,M,Q,R,S,X storage
          class U,Y,Z end
          class T skip