Session lifecycle for DeepSeek Harness: export, archive, restore, trash, search, stats. Zero dependencies, read-only by default.
Pending human review — the facts below come from the source repository.
Session lifecycle for DeepSeek Harness: export, archive, restore, trash, search, stats. Zero dependencies, read-only by default.
Users who want this capability in DSH; check the source and docs before installing.
dsh plugin --profile web add github:zoahdev/dsh-shelf No supported platforms were declared.
sh npx dsh-shelf list # every session with id + path npx dsh-shelf stats # counts, compressed/plain, bytes npx dsh-shelf search "parser bug" # header + body search (plain sessions) npx dsh-shelf export <id> --format md # Markdown transcript to stdout npx dsh-shelf export --all --format jsonl --out all-sessions.jsonl npx dsh-shelf archive <id> # move to sessions-archive (never deletes) npx dsh-shelf restore <id> # move it back npx dsh-shelf trash <id> # move to sessions-trash (recoverable) npx dsh-shelf restore-trash <id> npx dsh-shelf report # weekly session digest (Markdown) npx dsh-shelf report 30 --format json # 30-day digest as JSON npx dsh-shelf report 14 --format html --out shelf-report.html # offline dashboard npx dsh-shelf verify # session health check (orphan tool calls, unfinished, empty) npx dsh-shelf rescue <id> # export an un-resumable session's content npx dsh-shelf archive-old 30 # dry run: sessions older than 30 days npx dsh-shelf archive-old 30 --yes # move them to sessions-archive npx dsh-shelf web # local web panel at http://127.0.0.1:4174 DSH plugin mode (panel bound to the active profile): sh dsh plugin --profile web add github:zoahdev/dsh-shelf # panel at http://127.0.0.1:4174 (committed lib/, no build at install) Roots: --root overrides; default is $DSH_SESSIONS or ~/.dsh/sessions. Archive/trash roots default to sessions-archive / sessions-trash next to the root. ## Safety model - Listing, stats, export, and search are strictly read-only. - Archive/trash move a session directory; nothing is ever deleted by the engine. - Export never touches the source file. - Zstandard-compressed sessions are detected and reported (plain-JSONL export in v0.1; raw jsonl path preserved). ## Development sh node --test tests/shelf.test.mjs node scripts/shelf.mjs list --root <fixtures> ## Why this is the gap - Official discussions #1990 (no way to delete a conversation) and #1991 (archived sessions cannot be viewed or restored) are unanswered feature requests. - The session category has 229 plugins - memory, recall, evolution - but almost nothing for lifecycle. - dsh-shelf is the safe, scriptable first step: build export/archive/trash/search, then a web UI on top. ## Roadmap - [x] list / stats / export (md/json/jsonl) / archive / restore / trash / search - [x] weekly digest (report) + auto-archive (archive-old, dry-run by default) - [x] local web panel (dsh-shelf web) - list/search/export/archive/trash + daily chart from the browser - [x] offline HTML dashboard (report --format html) - shareable per-day bars + largest sessions - [x] Chinese search via CJK bigram tokenizer (zero-dependency; aligns with #1999) - [x] DSH plugin wrapper (dsh plugin add github:zoahdev/dsh-shelf opens the panel) - [x] session health check (verify) + rescue export for un-resumable sessions (#1959/#2034 family) - [ ] FTS5-backed search when the host provides SQLite FTS5 - [x] Zstandard export (node:zlib decode on Node >= 22.19) ## License MITNot by stars — picked by hand, one at a time.
A visual settings dashboard for DeepSeek Harness: every registered settings namespace — including third-party plugin ones the official UI never covers — rendered as editable, schema-driven forms. Early, but the right direction: stop hand-editing YAML.
A DIY trajectory visualizer for DeepSeek Harness: watch the agent’s plan and execution unfold as a graph instead of scrolling raw logs. Early, but it fills a real gap — understanding at a glance what the agent is doing.
Dispatch DSH work from Claude Code / Codex: spin up in-host DSH agent sessions with per-tier presets, watch native subagent progress, and borrow a multimodal bridge that lends the text-only harness vision and image generation. An orchestration plugin that turns DSH into a backend for other coding agents.