mayf3/dsh-session-doctor
Diagnose, unstick, and read DSH sessions: list sessions with agent status, read conversations, diagnose stuck agents, recover them with cancel+keepInbox, and send messages to other sessions.
dsh-session-doctor diagnoses, unsticks and reads DeepSeek Harness sessions. It provides five tools: list_sessions (title, id, cwd, persisted state, agent status and pending inbox counts), read_session (a session's user/assistant messages in time order, with a limit), session_status (online, running/idle, inbox pending counts, last event), session_recover (sends a cancel signal with keepInbox: true to a running agent -- aborting the stuck activity while keeping queued messages, which the agent processes once it settles to idle) and send_session_message (delivers directly when online, auto-resuming persisted sessions first). A typical flow: notice another session is stuck -> diagnose -> recover -> read its progress -> message it to continue.
Install
dsh plugin --profile web add dsh-session-doctorThe npm package dsh-session-doctor 0.2.1 was re-verified live on 2026-10-01 (the registry entry carries no repository field, so the name is taken from the README); a github:mayf3/dsh-session-doctor form is also documented.
Compatibility
DeepSeek Harness -- one process hosts many Agent sessions. Registers five session tools.
Details
- Repo: mayf3/dsh-session-doctor
- Category: Sessions & Messages
- Stars: 0
- Version: npm dsh-session-doctor 0.2.1 (registry re-verified 2026-10-01; no repository field on the entry)
- Last push: 2026-08-14
- First seen: 2026-08-14
Recent updates
The README documents the five tools and their purposes, the stuck-session scenario (e.g. a cordis_inspect_query waiting forever while later messages pile up in the inbox), and the recommended flow diagnose -> recover -> read -> message.
FAQ
- How do I install dsh-session-doctor?
- dsh plugin --profile web add dsh-session-doctor; the npm package 0.2.1 was re-verified on 2026-10-01.
- What does it fix?
- Stuck sessions -- session_recover can cancel a running agent with keepInbox: true, aborting the stuck activity while keeping queued inbox messages.
- How many tools does it add?
- Five: list_sessions, read_session, session_status, session_recover and send_session_message.
Alternatives
omdsh-dev/dsh-session-health · Mombrane/dsh-subagent-monitor · bwndlct/dsh-session-audit