dsh-plugin-dew
See what your other coding agents are doing — from inside DSH.
You run Claude Code in one window, Codex in another, maybe Cursor too. DSH can't
see any of it. This plugin gives DSH two read-only tools that parse the session
logs those agents already write to disk, and normalize everything to one
vocabulary: needs you / running / done / idle.
> is anything waiting on me?
3 matching sessions; 11 scanned over the last 8h (needs you 1, running 2, done 8, idle 0).
NEEDS YOU
· Claude Code · web-app (2m ago) — waiting for approval: Bash
RUNNING
· Codex · api-server (18s ago) — Refactoring the auth middleware
· DSH · notebook (44s ago) — running bash
It is a port of the readers behind Dew, a
macOS status bar for the same data.
Install
In DSH Desktop: Settings → Plugins, search for dsh-plugin-dew, install.
Or wire it into a profile by hand — add the dependency and list it as a bundle:
// ~/.dsh/profiles/web/package.json
{
"dependencies": { "dsh-plugin-dew": "^0.1.0" },
"dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-plugin-dew"] } }
}
Requires Node 20+. Reading DSH's own compressed transcripts additionally needs a
runtime with zlib.zstdDecompressSync (Node 23.8+); without it the other three
agents still work.
Tools
agent_sessions
Lists sessions and what each one is doing.
| Parameter | Type | Meaning |
|---|
agents | string[] | Restrict to claude_code, codex, cursor, dsh. Omit for all. |
state | string | One of the four states, or active (default, everything but idle), or all. |
within_hours | integer | Lookback. Defaults to 8. |
limit | integer | Cap on returned rows, highest priority first. Defaults to 25. |
Good for: "is my Claude Code run finished?", "which agent is blocked on me?",
and — before you start editing — "is another agent already working in this
directory?"
agent_scheduled_tasks
Lists recurring agent jobs and when each fires next: Codex automations (RRULE)
and Claude Code scheduled tasks (cron), evaluated locally.
| Parameter | Type | Meaning |
|---|
agents | string[] | Restrict to specific agents. |
include_disabled | boolean | Include switched-off tasks. Defaults to false. |
What it reads
Everything is read-only. The plugin never writes into another agent's data
directory, never touches a keychain or credential store, and makes no network
requests.
| Agent | Sessions | Scheduled tasks | Source |
|---|
| Claude Code | ✅ | ⚠️ | ~/.claude/projects/**/*.jsonl, ~/.claude/scheduled-tasks/ |
| Codex | ✅ | ✅ | ~/.codex/sessions/, ~/.codex/automations/ |
| Cursor | ✅ | — | ~/.cursor/projects/<slug>/agent-transcripts/ |
| DSH | ✅ | — | $DSH_HOME (default ~/.dsh) and the DSH Desktop harness dir |
⚠️ Claude Code scheduled tasks are implemented against the documented contract
but have never been observed on a real machine — the parser is defensive and
returns nothing rather than guessing.
How the states are decided
Each agent is different, and the honest summary is that only some of this is
explicit:
- Codex and DSH write explicit lifecycle events (
task_started /
task_complete, turn/start / turn/end), so running and done are read,
not inferred.
- Claude Code is inferred from the transcript tail: an
assistant row with
stop_reason: "tool_use" and no matching tool_result means a tool was
requested and has not returned.
- Cursor has the least to work with — no
tool_result rows and no
timestamps — so its state rests on the last row plus the file's mtime.
needs_you is always an inference. No agent writes a "waiting for approval"
event, so it is derived from a pending tool call that has gone quiet. The
threshold is per tool rather than a single number, because an approved long
Bash writes nothing to its log while it runs — silences of two to four minutes
are normal — and a flat threshold reports every slow command as a permission
prompt.
Privacy
agent_sessions returns a one-line summary of each session, which is an excerpt
of that conversation, and those summaries go to your model provider like any
other tool result. If that is not what you want:
config:
redactSummaries: true # report states and projects, no conversation text
Configuration
config:
agents: [] # limit the scan, e.g. ["claude_code", "codex"]
defaultWindowHours: 8 # lookback when a call does not specify one
redactSummaries: false
Development
npm test # node --test, no build step, no runtime dependencies
The plugin ships plain ESM — there is nothing to compile. @deepseek-ai/dsh-tools
and @deepseek-ai/schemastery are peer dependencies supplied by any DSH profile.
License
MIT
