dsh-session-artifacts: Organizing and Renaming Session Artifacts for DeepSeek Harness

What Does It Do?

Session Artifacts is a DSH plugin for DeepSeek Harness that keeps every AI coding session's output inside its own dedicated folder. It solves two real problems: a shared working directory that turns into hundreds of loose screenshots and temp files nobody dares to delete, and folder names that no longer match what actually happened weeks later. The workflow is simple — create a rough folder when work starts, rename it by real content when the session ends, then refresh the index. Three plain bash scripts ship alongside it and work in any agent environment.

Core Features

• Session consolidation: every session gets its own folder, and screenshots, verification scripts, temporary downloads and intermediate artifacts all go inside instead of the working directory root, /tmp or $HOME.
• Two-stage naming: start with a rough temporary name, then let the agent review what the session actually did and rename it, with the original date prefix preserved automatically.
• Index refresh: generates an INDEX.md summarizing date, session name, size, file count and a short abstract, so months-old work stays searchable by time and topic.
• Idempotent folder creation: repeated calls on the same day reuse the existing folder, while a forced new session gets an automatic numeric suffix.
• Safe renaming: supports fuzzy matching and a dry-run preview, and refuses to overwrite when a name already exists.
• Cross-agent compatibility: the three scripts are pure bash with no DSH dependency, so Claude Code, Codex, Cursor and other agents can use them directly on macOS and Linux.

How to Use This Plugin?

After enabling it in DSH, create the session folder the first time something needs to be saved; the script prints the full path, for example a dated folder ending in the session's rough topic. At the end of the session, have the agent review what was actually accomplished and rename the folder by content, such as changing a rough topic name into a release-and-finalization name, while the original date prefix is kept. Then refresh the index and INDEX.md is regenerated with date, session, size, file count and abstract. Naming works best as a verb plus an object, taking the main thread when a session covers several topics and joining genuinely parallel topics with a plus sign, while avoiding vague words like work, misc or cleanup. Put the full multi-topic list in the session's own README and keep the folder name short as an index key. The default root is a session-artifacts folder in your home directory and can be overridden by an environment variable, with old sessions moved into an archive subfolder.

How to Troubleshoot This Plugin?

Running the scripts directly on Windows may fail because they use bash arrays and double-bracket syntax, so use WSL or Git Bash instead. If a rename reports a duplicate name, the target is already taken; pick a more specific name, since the script refuses to overwrite. If you genuinely need a second session on the same day, a normal folder-creation call reuses the existing one, so follow the official instructions to force a new folder and the script will add a numeric suffix.