joejojoking-cloud/dsh-file-explorer
File explorer plugin for DeepSeek Harness: file tree, preview, markdown, syntax highlighting, in-panel editing
dsh-file-explorer is a global file explorer plugin for DeepSeek Harness: it adds a 'File' folder-switch button on the right side of every session's title bar; clicking it opens a resizable right-side panel showing the current working directory's file tree. The panel width is draggable from 260 to 900 px; a collapse button and double-clicking the chat area also close it. Features: search box that recursively scans the workspace (skips .git and node_modules, max 300 results); file tree with lazy directory expansion and single/double-click file preview; preview pane with rendered Markdown (headings, lists, code blocks, tables, links), syntax-highlighted code for common languages, inline image display, and raw-text fallback for other formats; title bar toolbar with VS Code integration (opens the whole workspace in VS Code), expand/collapse all, refresh, edit, and close buttons; in-panel editing of the currently previewed file. The panel is global — appears on any session without session-level configuration.
Install
dsh plugin --profile web add dsh-file-explorerInstall from npm with dsh plugin --profile web add dsh-file-explorer (npm package 0.1.1 registry-verified 2026-08-23). For a local checkout: dsh plugin --profile web add <path-to-package> where <path-to-package> is the directory of the cloned repo. Restart dsh web after install. The file panel opens in the title bar via a 'File' folder-switch button on the right side of any session header. Uninstall with dsh plugin --profile web remove dsh-file-explorer.
Compatibility
DeepSeek Harness web profile. Implemented as a shell.overlay (globally mounted overlay panel). The panel opens to the right side of the session view; the left edge is draggable (260–900 px); a '>' collapse button sits at the left edge center; double-clicking the chat area also closes the panel. Folder switch button in the session title bar (right side). File tree: lazy-loading, skips .git and node_modules, max 300 entries. Search: recursive scan, real-time filter. Preview: Markdown rendered (headings/lists/code/table/links), code with syntax highlighting for common languages, images inlined, other files shown as raw text.
Details
- Repo: joejojoking-cloud/dsh-file-explorer
- Category: Coding & Development
- Stars: 15
- Version: npm package dsh-file-explorer 0.1.1 (registry-verified 2026-08-23)
- Last push: 2026-08-31
- First seen: 2026-08-14
Recent updates
The current README documents: install (npm and local path), folder-switch button placement (session title bar, right side), panel behavior (resizable 260–900 px, collapse button, double-click-to-close), search (recursive, .git/node_modules skipped, max 300), file tree (lazy directories, click to expand, single/double-click preview), preview types (Markdown rendered, code highlighted, image inlined, raw fallback), toolbar (VS Code open, expand/collapse all, refresh, edit, close).
FAQ
- Does the file explorer work in every session?
- Yes — the panel is globally mounted (shell.overlay) and the folder-switch button appears in every session's title bar; no per-session setup is needed.
- Can I edit files from the panel?
- Yes — the toolbar includes an edit button for the currently previewed file, and the 'VS Code' button opens the entire workspace directory in VS Code.
- What file types are previewed?
- Markdown renders with headings/lists/code blocks/tables/links; code files show syntax-highlighted source for common languages; images are displayed inline; all other file types fall back to raw text.
Alternatives
LAN-TINA-WS/dsh-gui-customization · taxueseek/dsh-files · ccq1/dsh-side-panel