widgetful

Reference

Hook events

The event of each agent that sets each session state.

Claude Code

EventState
SessionStartDone (the session waits for a first prompt)
UserPromptSubmit, PreToolUse, PostToolUseWorking
NotificationWaiting
StopDone
SessionEndStopped (the session leaves the list)

Codex

EventState
SessionStart, Stop, InterruptDone
UserPromptSubmit, PreToolUse, PostToolUseWorking
PermissionRequestWaiting
SessionEndStopped

OpenCode

The Widgetful plugin sends these events. It sends one event at a time, so that the states arrive in the correct order.

EventState
session.status busy or retry, permission.repliedWorking
session.status idle, session.idleDone
permission.askedWaiting
session.deletedStopped