Session Folders

One isolated folder per new conversation, with names that stay in sync with the session title.

中文文档

Session Folders is a DSH host and client plugin for temporary or uncategorized conversations. Every new session in the default workspace gets its own working directory without creating another sidebar workspace or changing workspace ownership.

Why

Scratch conversations often share the same default directory. One chat can leave scripts, downloads, or test files that confuse the next chat. Session Folders isolates those files at the filesystem level while preserving DSH's existing workspace and history model.

Features

• Creates one folder for each new conversation in the default workspace.
• Uses the first message as an initial readable name.
• Renames the folder when the generated or edited session title changes.
• Resolves collisions with -2, -3, and so on.
• Uses the native Windows folder picker for the parent directory.
• Checks that the selected folder is accessible.
• Supports immediate creation or creation on the first message.
• Recovers folders and title synchronization after a DSH restart.
• Keeps DSH's Open In button and local-file actions pointed at the active session folder.
• Never creates extra workspace entries or changes historical workspace ownership.
• Leaves files written to explicit absolute paths elsewhere untouched.

Requirements

• DSH >=0.2.1-rc.3 <0.3.0
• Node.js 22 or newer for development

Install

dsh plugin add dsh-per-session-folder

Before the npm package is published, install directly from GitHub:

dsh plugin add github:hhuapen/dsh-per-session-folder

For a local checkout:

dsh plugin add C:\path\to\dsh-per-session-folder

Restart DSH after installation.

Setup

Open Plugins → Installed plugins → Session Folders.

The configuration embedded in the plugin detail page provides:

• Choose folder… — select the parent directory used for new session folders.
• Use default workspace — clear the custom parent directory.
• Create on open — allocate a folder as soon as a new chat is opened.
• Create on first message — avoid empty folders by waiting for the first prompt.

The selected folder is checked for accessibility. If a folder cannot be used, the session continues in the default workspace instead of blocking the conversation.

Configuration

Key	Default	Description
enabled	true	Enable per-session folders
root	''	Parent folder; empty uses the default workspace
creationMode	immediate	immediate or first-message
workspacePath	''	Optional workspace override for advanced setups
maxNameChars	60	Maximum folder-name length

Scope and behavior

Session Folders affects only new, top-level sessions whose original working directory is the default workspace. Historical sessions, subagent sessions, and sessions in other workspaces are left unchanged.

The session header keeps the original workspace path. Only the effective working directory changes through ctx.workingDirectory.set(agent, path), which is durable and replayed by DSH. The client plugin mirrors that effective directory into DSH's session UI when the required client interface is available, so directory-opening controls target the managed folder.

Each managed folder contains .dsh-per-session-folder.json. This marker lets the plugin recover its folder after a restart. Folders created by the earlier development name retain their legacy marker and are adopted automatically.

Limitations

• Only operations that resolve relative to the current working directory are isolated. Absolute paths intentionally written elsewhere are not intercepted or moved.
• Changing the parent directory affects only future sessions. Existing folders stay put.
• The plugin never deletes or archives folders automatically.
• Renaming a folder can invalidate an old path already mentioned earlier in a model turn. The next model step receives a working-directory change notice.

Development

npm test

The test suite covers naming, collision handling, restart recovery, workspace scoping, subagent exclusion, path failure fallback, deferred creation, and client directory syncing.

License

MIT