Journal Recorder Agent

journal-recorder — auto-journal for Claude Code & Codex

Automatically records your [Claude Code](https://claude.ai/code) and [Codex CLI](https://github.com/openai/codex) sessions as rich, shareable markdown journal entries. Triggers at conversation end, on every `/compact`, and after every Codex turn.

Each entry includes: what was worked on, commands run, files touched, decisions made, problems solved, and action items — written so anyone with zero prior context can understand it.

**Built for the human, not the agent.** AI sessions vanish the moment they end — a week later you can't remember which flag fixed the build or why you chose that architecture. This journal is *your* memory: remember what you did, find that command from three projects ago, hand a teammate the full story. It is **not** agent memory — Claude and Codex have their own memory systems for carrying context between sessions; this exists so *you* can remember and find things.

Entries are organized **per project**, indexed, git-tracked, **auto-pushed to GitHub**, and generated in the **background on Haiku** so your session never waits.

~/claude-journal/                         ← git repo, auto-pushed if remote set
├── my-repo/
│   ├── INDEX.md                          ← auto-maintained index
│   ├── 2026-07-17_14-30_auth-refactor.md ← session journals
│   ├── commits/                          ← per-commit journals (optional git hook)
│   └── .last-written                     ← per-project dedup marker
├── other-project/
├── digests/2026-W29.md                   ← weekly digests
└── .journal.log                          ← every run logged here

---

Install

**Requirements:** [Claude Code](https://claude.ai/code) or [Codex CLI](https://github.com/openai/codex) (either works — generation prefers `claude -p`, falls back to `codex exec`), Python 3 (preinstalled on macOS)

**One command:**

curl -fsSL https://raw.githubusercontent.com/GauravRatnawat/journal-recorder-agent/main/in