⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
agent-diary
>-
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
agent-diary
Pull learnings, bugs, and fixes from AI agent sessions into a local HTML diary and an interactive Claude Code Mod pane with Marcus Aurelius style notes.
git clone https://github.com/hemanth/agent-diary.git
cd agent-diary
npm link
ln -s "$PWD" ~/.gemini/config/skills/agent-diary
ln -s "$PWD" ~/.claude/skills/agent-diary
Quick start
# Scan recent sessions from Antigravity and Claude Code
npm run harvest
# Build and open diary.html
npm run open
harvest.mjs reads .jsonl transcripts for errors, follow-up questions, and fixes. build-diary.mjs compiles data/diary-entries.json into diary.html, docs/index.html, and DIARY.md.
Claude Code Mod
agent-diary includes a Claude Code Mod (hooks/register.js) that draws an interactive pane inside your terminal or Claude Desktop app.
# Load from ~/.claude/skills/agent-diary or pass --plugin-dir directly
claude --plugin-dir .
# Validate and run the mod test suite
npm run validate
npm test
Inside a Claude Code session:
/diaryopens the interactiveAgent Diary (Ta Eis Heauton)pane with three tabs:1: Entries,2: Meditations, and3: Write Note./diary-note <reflection>saves a personal note straight from the prompt into$.storeanddata/diary-entries.json./diary-openopensdiary.htmlin your browser.- Hotkeys inside the pane:
1/2/3switch tabs,n/pcycle entries,mdraws another Stoic meditation lot,btoggles theAbovePromptStoic quote banner, andoopens the HTML diary.
CLI usage
# Sync latest sessions and open diary.html in your browser
agent-diary
# Print recent sessions in the terminal
agent-diary harvest
# Sync and rebuild without opening a browser tab
agent-diary sync
Add an entry from the terminal
node scripts/build-diary.mjs --add-json '{
"id": "entry-2026-10-05-my-project",
"date": "2026-10-05",
"project": "my-project",
"title": "Zero-copy buffers in the audio worker",
"summary": "Removed redundant ArrayBuffer copies on the hot path.",
"virtue": "Economy and Precision (Euteleia)",
"challenges": ["GC pauses hit 45ms when cloning 16MB audio frames."],
"solutions": ["Passed ownership with postMessage transferable ArrayBuffers."],
"learnings": ["Transferables move ownership in O(1) without copying bytes."],
"meditation": {
"book": "Book IV",
"verse": "Section 24",
"stoicConcept": "Apallage (Pruning the unnecessary)",
"quote": "Why copy the vessel when you can hand it across the threshold?",
"reflection": "Most latency comes from extra work we added ourselves. Pass the buffer directly."
},
"userNote": "Cut frame latency from 45ms to 0.2ms."
}' --open
Automatic background hook
agent-diary registers a Stop hook in ~/.gemini/config/hooks.json (Antigravity), ~/.claude/settings.json (Claude Code settings), and turn.complete in hooks/register.js (Claude Code Mod). When a turn ends, scripts/auto-hook.mjs pulls new sessions into data/diary-entries.json and rebuilds diary.html without overwriting your manual notes.
License
MIT (c) Hemanth.HM
// HOW IT'S BUILT
KEY FILES