All shelves / Mods / Workflow
session-monitor
By vumichien
session-monitor is a Claude Code workflow mod by vumichien.
Draws a band of your other Claude Code sessions, how many wait on you, work, or are done, with their own line for sessions in this folder.
Draws
Install
The marketplace name is chien-mods.
claude plugin marketplace add vumichien/claude-code-mods-kit claude plugin install session-monitor@chien-mods
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.1.1
- License
- MIT
- Repo stars
- 4
- Last change
- 2026-10-10
What it can reach
- Draws in the session
Start a new session after installing, then turn it on with /session-monitor on; it starts off. Tested on Claude Code 2.1.296 on Windows 11; mods are an early-access feature, so the API can change between versions. Each session that has it on writes one small file under ~/.cache/claude-mods/session-monitor/, about 240 bytes, and the files stay until you delete the folder. A file not rewritten for 90 seconds, from a killed session, is skipped. It has no options. To try it for one session without installing, git clone the repository and start claude with --plugin-dir pointing at the mod's folder.
The marketplace, chien-mods, also holds secret-guard, plan-meter, done-gate, context-meter, idea-shelf, prompt-enhancer, and assumption-check, each installed on its own. Seeing which of your sessions need you is why this page files it under workflow. notice-board, by HolyGrail, draws a band of notices for the other sessions in this repo, or for every session on the machine. baton draws a band above the prompt of this session, the other sessions, and the tasks passed between them. This one shows state only: waiting, which means a permission dialog or a question is open, first and in the colour for needs you, then working, then done. Each session's file holds its id, folder, state, times, and a title, and no prompt or command text, and the README says it sends nothing to the model. It is the only mod in its marketplace that writes files outside Claude Code's own store.
Demo

What it hooks into
session.startWhen a session startscommand.runWhen you run its slash command/session-monitorclassic.SessionStartA Claude Code eventclassic.UserPromptSubmitA Claude Code eventturn.startWhen Claude starts a turnturn.completeWhen a turn endstool.checkA Claude Code eventtool.callAround a tool call, where it can hold onesession.endWhen a session endsui.closeWhen its pane closesui.renderDraws into the sessionAbovePromptPane
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/session-monitorSwitch the session monitor on or off, show its status, or list the other open sessions
Files
The author's source, 3 files. They load when you open them.
Facts
- Author
- vumichien
- Category
- Workflow
- Marketplace
- chien-mods
- Folder
- plugins/session-monitor
- Version
- 0.1.1
- License
- MIT
- Repo stars
- 4
- Last change
- 2026-10-10
- Language
- TypeScript
- Files
- 7