ClaudeCodeMod

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.

In your shell
claude plugin marketplace add vumichien/claude-code-mods-kit
claude plugin install session-monitor@chien-mods
Open the repo

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

The session-monitor paragraph of the author's claude-code-mods-kit README: each session with it on writes one small file under ~/.cache/claude-mods/session-monitor/ with its id, folder, state (working, waiting or done), times and a title, and no prompt or command text; it is rewritten at every change of state and every 15 seconds; a file not rewritten for 90 seconds is skipped; it sends nothing to the model and costs none.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • command.runWhen you run its slash command/session-monitor
  • classic.SessionStartA Claude Code event
  • classic.UserPromptSubmitA Claude Code event
  • turn.startWhen Claude starts a turn
  • turn.completeWhen a turn ends
  • tool.checkA Claude Code event
  • tool.callAround a tool call, where it can hold one
  • session.endWhen a session ends
  • ui.closeWhen its pane closes
  • ui.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
Repo
vumichien/claude-code-mods-kit
Folder
plugins/session-monitor
Version
0.1.1
License
MIT
Repo stars
4
Last change
2026-10-10
Language
TypeScript
Files
7

Other mods in Workflow

caffeinezienagReminds the agent of each shell it left running in the background, and toasts when a reminder wakes an idle session.where-am-ihamzaferDraws four things above the prompt: the goal, what is happening now, what is waiting on you, and the next step.next-stepshamzaferAfter each turn, draws two or three likely next prompts. In an empty prompt, 1, 2, or 3 drafts one. 0 dismisses them.agent-radarhamzaferDraws one line above the prompt for each running subagent: time, tool count, and what it is doing.mission-controlhamzafer/mission opens a pane of the main agent, its subagents, every tool call, and the files they touch.agent-quick-menuagentic-workbenchPuts installed plugins' commands and settings, and Claude Code's own settings, in a pane beside the session, with a favorites line above the prompt.browser-laneshamzaferHolds a commandDraws whether this session has a Playwright browser and who holds it. A subagent that wants the browser waits until the one using it is done.glancehamzaferDraws one line above the prompt for what needs you: the next meeting, pull requests, Linear issues, and Slack DMs.session-saverhamzafer/park saves where you left off. The next time that session resumes, it draws the note.prayer-timeshamzaferDraws the current prayer and how long is left, the next prayer, and zawal, above the prompt. Computed on your computer. The author says nothing is sent out.tool-radarSingh-APDraws a pane of every tool call as it happens, with status, arguments, duration, and failures.git-pulseSingh-APDraws the branch, ahead and behind, and dirty files on the status line, and a heads-up when Claude commits.
All 396 in Workflow