claude-code

aimemo × Claude Code

Claude Code reads CLAUDE.md automatically at the start of every session. aimemo setup installs three hooks and writes a context block into CLAUDE.md — the full memory loop runs with zero manual steps, ever.

---

Setup

Run once in your project root:

aimemo setup --claude

Then bootstrap from your git history so the agent has context from day one:

aimemo bootstrap

---

What gets installed

Three hooks in .claude/settings.json:

Hook	Trigger	What it does
PostToolUse	After every Write / Edit / MultiEdit	Runs aimemo capture — auto-logs the file with a code description
UserPromptSubmit	At the start of each session	Runs aimemo inject --claude --once — injects fresh context
Stop	When you close Claude Code	Runs aimemo inject --claude — saves context for next session

.claude/settings.json (excerpt):

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit|MultiEdit",
        "hooks": [{ "type": "command", "command": "aimemo capture" }]
      }
    ],
    "UserPromptSubmit": [
      {
        "hooks": [{ "type": "command", "command": "aimemo inject --claude --once" }]
      }
    ],
    "Stop": [
      {
        "hooks": [{ "type": "command", "command": "aimemo inject --claude" }]
      }
    ]
  }
}

CLAUDE.md (excerpt):

<!-- aimemo:instructions:start -->
## aimemo — persistent memory
- At session start: run `aimemo inject --claude` to load context from previous sessions
- After modifying any file: run `aimemo log "modified {filename}: {one-line reason}"`
- When you identify something to fix later: run `aimemo log "todo: {description}"`
- At session end: run `aimemo recap "{what was done} — next: {what comes next}"` then `aimemo inject --claude`
<!-- aimemo:instructions:end -->

<!-- aimemo:start -->
## aimemo context
last: (no entries yet)
<!-- aimemo:end -->

---

The session loop

Open Claude Code
      │
      ▼
UserPromptSubmit hook → aimemo inject --claude --once
      │  (injects context only if new entries exist)
      ▼
Claude reads CLAUDE.md ←── recap + recent entries + open todos
      │
      ▼
You work — Claude edits files
      │
      ▼
PostToolUse hook → aimemo capture
      │  (logs "wrote src/auth.rs: added fn handle_login"
      │   or  "edited src/db/pool.rs: added fn connect_pool"
      │   or  "edited src/auth.rs (3 changes)" if no pattern matched)
      ▼
Claude logs semantic context:
  aimemo log "modified src/auth.rs: extracted JWT validation"
  aimemo log "todo: add refresh token endpoint"
      │
      ▼
At session end:
  aimemo recap "implemented JWT auth — next: refresh token endpoint"
      │
      ▼
You close Claude Code
      │
      ▼
Stop hook → aimemo inject --claude
      │
      ▼
CLAUDE.md updated silently — ready for next session