Sttrevens / dsh-linked-folders

@steven-wu/dsh-linked-folders

Out-of-tree dsh plugin that gives a session multi-folder workspace access — like Codex's linked folders.

• A global linked-folders list (durable, cross-session) — your "global workspace".
• Per-session temporary links the model adds/removes on the fly with link_folder / unlink_folder.

Both lists are injected into the system prompt, so the model knows which extra roots it may cd into and work across.

Install

The package declares a dsh.bundle manifest, so dsh plugin add installs it and adds it to the profile's bundle layers automatically:

dsh plugin --profile web add @steven-wu/dsh-linked-folders
# restart the web profile, then refresh the page

Use

• Sidebar → footer → 📁 Linked folders (N). Expand it to see the global list, add a folder by absolute path, or remove one with ×.
• Model: say "link folder /path/to/foo" — the agent calls link_folder; "unlink /path/to/foo" calls unlink_folder. Session links appear in the prompt as (this session).

Configuration

State lives in ~/.dsh/linked-folders.json:

{
  "global": ["/Users/you/projects/app", "/Users/you/projects/lib"],
  "sessions": { "session-abc…": ["/tmp/scratch"] }
}

Override the path with the DSH_LINKED_FOLDERS env var or the bundle row's config.path. Linked folders are canonicalized to real paths and must be existing directories.

Sandbox note

The plugin only advertises folders to the model and provides the management UI; it does not change the file sandbox. Under danger-full-access the model can read/write anywhere; under workspace-write it can read linked folders but writes are still confined to the session workspace root.

Model experience

• System prompt: a ## Linked folders section listing global + session roots.
• Tools: link_folder(path) / unlink_folder(path).
• Web Remote: the client bundle explicitly mounts the linkedFolders Remote contribution before the sidebar consumes it (required by dsh rc.6+).
• Prompt token cost: proportional to the number of linked folders (one short line each), zero when none are linked.