openagfs/dsh-agfs

File browser web plug-in (npm @open-agfs/dsh-agfs, dsh plugin add one-line installation): Host webserver hosted in the same process React front-end + REST API + /dsh-agfs command + browse_files/read_file model tool; one-click AI analysis (right-click to create a workspace and wake up a new session, consistent with manually created agent preset Toolset), local opening (system file manager), three display sizes, Win10 file manager theme (Segoe MDL2 Assets official icon); 109 single test + real Loader/HTTP combination test all green, rc.6 web profile passed the actual test (one-click analysis, real run 55 tool calls, 0 errors)

A file-browser web app for DeepSeek Harness: a React frontend and REST API served by the host webserver, plus a /dsh-agfs command and browse_files / read_file model tools. The UI offers clickable breadcrumbs, list and card views, three display sizes (windowed / viewport / fullscreen), a sidebar with project directory, quick-access folders, custom roots and drives, recursive search (200-hit cap), local "open in file manager", and text/image preview with create/rename/copy/delete of folders. Right-clicking a file or folder offers one-click AI analysis that creates a workspace for that directory and wakes a fresh session whose agent analyzes it with the full standard tool set. The /dsh-agfs command opens the browser at the current session's workspace directory.

Themes & Skins ★ 1 updated 2026-08-15 — untested
View on GitHub ↗

Install

dsh plugin --profile web add @open-agfs/dsh-agfs

README install Option 2 (one-line CLI). Option 1 asks the agent in the dsh web dialog to install the npm package @open-agfs/dsh-agfs (the agent runs the same shell command; that flow needs the agent's shell tools enabled and permitted). After installing, restart dsh web and run /dsh-agfs in the dialog to open the file browser. Upgrade with dsh plugin --profile web add @open-agfs/dsh-agfs@latest. npm package @open-agfs/dsh-agfs 0.1.9 (registry-verified 2026-09-10; registry repository field -> github.com/openAGFS/dsh-agfs).

Compatibility

Rides the composing dsh web server — no separate port, no subprocess. Install as a profile bundle (dsh.bundle), restart dsh web. Path safety is configurable: browsing is confined to the root, strictRoot adds real-path checks and intercepts symlink/junction escapes, readOnly mode turns write endpoints into 403s and remoteMode disables the open/open_location/copy endpoints. The frontend ships React/ReactDOM in the package, so it boots without a CDN or Babel.

Details

Recent updates

README documents the security posture: browsing is confined to the configured root, strictRoot performs real-path checks and intercepts symlink/junction escapes with a clean 400 envelope, readOnly and remoteMode trim the write/open surface, and responses carry X-Content-Type-Options: nosniff, X-Frame-Options: DENY and Referrer-Policy: no-referrer.

FAQ

How do I install dsh-agfs?
Run: dsh plugin --profile web add @open-agfs/dsh-agfs, then restart dsh web and run /dsh-agfs in the dialog (upgrade with the same command plus @latest).
Why does the agent-driven install fail?
That flow needs the agent's shell tools (bash/pwsh) enabled and permitted — the web profile disables shell tools by default. Enable them under Settings -> tools/permissions, or approve the command when asked, or use the one-line CLI install instead.
How do I lock the file browser down?
Set strictRoot: true to keep browsing inside fileRoot (absolute paths rejected, symlink/junction escapes fail with a 400 envelope), readOnly: true to make delete/create_folder/rename/copy answer 403, and remoteMode: true to disable the open/open_location/copy endpoints.

More plugins in Themes & Skins

Browse more in Themes & Skins

Guides for Themes & Skins plugins