zoahdev/dsh-shelf
Session lifecycle CLI: export (md/json/jsonl), archive/restore, trash, search, and stats. Read-only by default; nothing is ever deleted by the engine.
Session lifecycle for DeepSeek Harness: export, archive, restore, trash, search and stats for your dsh session library, with zero dependencies and read-only by default. The README's premise is that every dsh user accumulates hundreds of sessions with no way to manage them. The CLI lists sessions with id and path, reports counts/compressed/plain/bytes, searches header and body text, exports Markdown transcripts or all sessions as JSONL, moves sessions to sessions-archive (never deletes) and sessions-trash (recoverable) with restore commands, produces weekly or N-day digests as Markdown/JSON/offline-HTML dashboards, verifies session health (orphan tool calls, unfinished, empty), rescues an un-resumable session's content, dry-runs then applies bulk archiving of old sessions, and prints session fork lineage or a message tree. The plugin wrapper opens the same panel as a local web UI.
Install
dsh plugin --profile web add github:zoahdev/dsh-shelfREADME install line quoted verbatim for the plugin wrapper (the panel is then at http://127.0.0.1:4174; the README notes the committed lib/ means no build at install). Most of the README documents the standalone CLI used via npx dsh-shelf .... Registry-verified live 2026-09-15: dsh-shelf returned HTTP 404 on registry.npmjs.org, so the GitHub form is used and no npm ownership or version claim is made.
Compatibility
The README describes the plugin wrapper plus a read-only-by-default CLI over your dsh session library; it also exposes a local web panel on 127.0.0.1:4174.
Details
- Repo: zoahdev/dsh-shelf
- Category: Sessions & Messages
- Stars: 0
- Version: README does not pin a version (npm name did not resolve on 2026-09-15)
- Last push: 2026-08-22
- First seen: 2026-08-15
Recent updates
The README documents the command surface rather than a release-by-release changelog; the npm name did not resolve when checked on 2026-09-15.
FAQ
- How do I install the plugin?
- The README's plugin form is dsh plugin --profile web add github:zoahdev/dsh-shelf, which opens a panel at http://127.0.0.1:4174; a standalone CLI is also available through npx dsh-shelf.
- Will it delete my sessions?
- The README says it is read-only by default and that archive moves sessions to sessions-archive without deleting, while trash is recoverable via restore-trash.
- What can it report?
- Counts, compressed/plain status and bytes, weekly or N-day digests as Markdown/JSON/offline HTML, session health checks, fork lineage and message trees.
Alternatives
beijingwahw/dsh-companion · caoqinnan-web/organize-workspace-sessions · chouyong/dsh-fork-graph