dsh-plugin-delete-archived
Permanently delete archived DeepSeek Harness sessions and their on-disk logs.
DSH's built-in archive only hides a session from the sidebar — its history and log files stay on disk. This plugin erases an archived session together with its physical directory, while keeping restore as a way back.
English | 简体中文
Features
Settings → Archived Sessions
Lists every archived session with its disk directory, size, archive time and workspace. Rows are selectable, with batch Restore and Delete Permanently. Sorted oldest first by default, and every destructive action asks for confirmation first.
demo
Sidebar session menu
Archived sessions gain a Delete Permanently entry in their "⋯" menu.
demo
Agent tool
delete_archived_sessions removes one session by session_id, or every archived session when session_id is omitted. Sessions that are not archived are never touched.
Install
Paste this into DSH's Settings → Plugins → install entry:
github:Seelerc/dsh-plugin-delete-archived
Or just ask the agent to install it — plugin_manager, action: "install_bundle", target: "github:Seelerc/dsh-plugin-delete-archived".
Prerequisites
A github: spec is resolved with pnpm and git. The desktop app injects its own bundled pnpm, but a standalone CLI profile looks for both on your PATH.
- Missing
pnpm → npm i -g pnpm (or corepack enable pnpm)
- Missing
git → install Git, e.g. winget install Git.Git; pnpm runs git ls-remote to resolve a github: address before downloading anything
HTTP API
Routes registered on DSH's web server, for scripts and integrations.
| Method | Path | Body | Response |
|---|
GET | /api/archived-sessions | — | { sessions: ArchivedSession[] } |
POST | /api/archived-sessions/delete | { sessionId } | single-delete result |
POST | /api/archived-sessions/delete-batch | { sessionIds? } | { total, deletedCount, errors } |
POST | /api/archived-sessions/restore | { sessionId } | { success, sessionId } |
POST | /api/archived-sessions/restore-batch | { sessionIds } | { success, restoredCount } |
POST | /api/archived-sessions/open-folder | { path } | { success } |
Omitting sessionIds on delete-batch means "delete every archived session".
interface ArchivedSession {
id: string;
title: string;
cwd?: string;
workspaceTitle: string;
diskPath: string; // placeholder when no standalone directory is found
sizeBytes: number;
sizeFormatted: string; // e.g. "1.2 MB"
createdAt: string | null; // ISO 8601
}
Project layout
dsh-plugin-delete-archived/
├── lib/
│ ├── index.js # backend: HTTP routes, agent tool, disk cleanup
│ └── client.js # frontend: settings page + sidebar menu (AMD loader)
├── locale/
│ ├── zh.json # Chinese strings
│ └── en.json # English strings
├── cordis.patch.yml # loader injection declaration
└── package.json # manifest: exports / dsh.bundle / dsh.client
How it works
- Locating the directory: tries
sessionPersistence.findLog(sessionId) first, then falls back to scanning persistence.root for a directory named after the encoded session id.
- Permanent delete: erases the disk directory → detaches the session from its workspace → removes it from the archived set → clears the persistence handles and caches.
- Frontend injection: the client registers via
window.__ModuleLoader__.load() and injects into the settings.section and sidebar.workspaces.session.menu.item slots.
⚠️ Warning
"Delete Permanently" is irreversible — it truly erases session history and log files from disk. No recycle bin, no recovery. Every delete entry point asks for confirmation, but please double-check that you no longer need the session. If you only want it out of the sidebar, DSH's native Archive is enough.
Development
Plain JavaScript, no build step. Edit lib/client.js and the change applies immediately while the DSH client-plugin HMR receiver is active; otherwise restart DSH.
License
MIT
