agent-journal

by Chris Cook · ★ 8 · updated 8 days ago

PanesReskinsGuardsCommandsPromptTools & agentsvalidates

0

A journal written by your agent, autonomously. One small markdown file per milestone, written as the work happens, in a format built to be scanned with grep and ls.

install agent-journal

Install

git clone https://github.com/zirkelc/agent-journal
claude --plugin-dir ./agent-journal/claude-code

Then run /reload-plugins or start a new session. Requires Claude Code 2.1.287+.

View source on GitHub

What it hooks into

From an automated scan with claude plugin validate, not a security review. Mods run with your permissions; read the code before installing.

Events
session.startprompt.contextsession.compactprompt.submitturn.startagent.offertool.describetool.callui.rendercommand.runturn.completesession.endui.pressui.inputui.closeui.scroll
API calls
$.agent.list$.agent.register$.agent.spawn$.clock.after$.command.register$.env.get$.fs.stat$.process.run$.prompt.fill$.session.append$.session.cwd$.session.id$.session.messages$.session.model$.session.repo$.state.get$.state.set$.store.get$.store.set$.tool.check$.tool.register$.ui.close$.ui.invalidate$.ui.open$.ui.resolve$.ui.toast
Draws
ToolUseToolResultPane
Can see
the system promptcompactionevery prompt/"^mcp__agent-journal__write$"/ calls/"^mcp__agent-journal__(list|read)$"/ callsWrite calls
Reach
level 2 of 3 runs processesdrives Claudewrites the prompt boxreads filesreads env varsreads the transcriptreads mod statepersists statedraws

Origin

How it got here
Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of ).
Repository
github.com/zirkelc/agent-journal
Path in repo
claude-code
Source commit
a48538c the exact code the scan read
Author
Chris Cook @zirkelc
License
MIT
First published
Last pushed
First listed here

Name and description come from the mod's own manifest. We link to the code; we don't host it, and it stays under its author's license.