AI Agent Hub
Back to plugins
🧠

dsh-archived-sessions

Memory Updated 2026.09.16

Run the following command in DeepSeek Harness:

dsh plugin install kaelorvyn/dsh-archived-sessions

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install kaelorvyn/dsh-archived-sessions in your DeepSeek Harness terminal to install; the source lives at https://github.com/kaelorvyn/dsh-archived-sessions . Restart DSH after installation to activate the plugin.

About this plugin

After months of daily use, DSH quietly accumulates a pile of archived sessions: they vanish from the sidebar yet still sit on disk, and the current release ships no public API to unarchive or delete them. dsh-archived-sessions fills that gap by adding a dedicated Archived Sessions page under Settings, listing every archived entry with its title, working directory, and last activity, so you can finally see exactly how many hidden sessions you carry and where they live.

Two actions drive the page: Restore and Delete Permanently. Restore unarchives the session in place; the row disappears and the session reappears in its original group, with the sidebar updating live and no page refresh needed. Delete Permanently removes the entire session directory from disk and reports how much space was freed. If a session was ever moved between groups and left copies in multiple directories, every matching directory is removed so nothing lingers. For sessions imported from Codex, the source files are deleted as well, preventing the next import from resurrecting them. In batch mode, one Multi-select toggle reveals checkboxes on every row, and a single confirmed command carries all selected ids: the host validates once, commits once, and reports a single total size, so a partial delete never happens.

Safety is a first-class concern. Session ids must match a strict regex that rules out path traversal at the source, and the resolved absolute path must still fall inside the sessions root as a second line of defense. Structurally, only sessions in the archive set are reachable, so the session currently in use simply cannot be targeted. The delete button requires two clicks with a cancel option in between; a batch is rejected outright if any single id fails validation; and the per-call cap is 1000 ids. Because the plugin calls internal methods that are not part of a public contract, the host guards each call with a type check: if a future release renames or removes them, the plugin surfaces a clear error instead of touching any data.

This plugin is for long-term DSH users whose archive has grown past what a manual cleanup can handle, for anyone who migrated from Codex and wants a clean break rather than a permanent shadow copy, and for those who want to reclaim disk space without guessing which directories are safe to remove. Install it, restart DSH, and the sessions that used to be invisible but still consuming space are finally in one place.

Use Cases

  • The archive has grown large and you want to review, restore, or permanently remove sessions in one pass.
  • Codex-imported sessions keep reappearing after the next import because only the DSH copy was deleted; you want a clean break.
  • Disk space is tight and you need a safe way to reclaim space from sessions you no longer need.

Best For

  • Long-term DSH users whose archive has grown beyond what manual directory scanning can handle.
  • Developers who migrated from Codex and want a permanent break from shadow copies.
  • Any DSH user who wants to reclaim disk space safely without guessing which directories to remove.