agent-state

by kleinheinczg · ★ 0 · updated 9 days ago

GuardsCommandsPromptAutomationvalidates

0

Reports what a Claude Code session is really doing (idle / working / tool / permission, plus signals and token use) from inside the session, as a JSON snapshot and a JSONL event log

install agent-state

Install

/plugin marketplace add kleinheinczg/claude-code-agent-state-mod
/plugin install agent-state@agent-state

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.startturn.startturn.stepturn.completeprompt.editprompt.submitcommand.runtool.calltool.checkprompt.suggestclassic.StopFailureclassic.Notificationsession.measuresession.end
API calls
$.clock.every$.clock.sleep$.env.get$.fs.exists$.fs.read$.fs.write$.session.id$.session.usage$.session.version
Can see
every promptevery tool callclassic hooks
Reach
level 2 of 3 writes filesreads filesreads env vars

Origin

How it got here
Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of ).
Repository
github.com/kleinheinczg/claude-code-agent-state-mod
Path in repo
repository root
Source commit
f4794e1 the exact code the scan read
Author
@kleinheinczg
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.