Skip to main content

pilot-harness/packages/workspace/ui-worktree

240Stars13Forks16Issues1Watchers

Provides a workspace file tree panel for DeepSeek Harness Web, with one-click toggle in the conversation page header. Supports creating and renaming files/directories, and adding paths to the conversation draft.

Evidence4/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki

ⓘ This plugin is a sub-package of the op7418/pilot-harness monorepo — stars and activity count the whole repository.

Language
TypeScript
License
MIT
Branch
main
ai-agentcodepilotdeepseekdeepseek-harnessdesktop-appdshdsh-pluginelectron

Install

cmdweb profile
$ dsh plugin --profile web add github:op7418/pilot-harness#path:packages/workspace/ui-worktree

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin op7418/pilot-harness/packages/workspace/ui-worktree for me: review the repository at https://github.com/op7418/pilot-harness first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Line Description

pilot-harness (package name @deepseek-ai/dsh-ui-worktree, Cordis plugin ID pilot-worktree) is the workspace file tree panel for DeepSeek Harness Web edition. A "Files" toggle button appears in the conversation page header; when clicked, a real-layout file directory tree appears on the right side, facilitating browsing the current project, creating/renaming files/directories, and quickly adding file paths to the conversation draft in the @path format.

Core Features

  • Adds a "Files" toggle button in the session header, opens the right-side file tree sidebar and automatically narrows the conversation area width
  • Lists the current Workspace's directory tree with nested expansion and directory/file sorting
  • Displays the count of visible files in the Workspace root directory (automatically skips .git, .DS_Store, node_modules, symbolic links)
  • Each file/folder row provides a three-dot menu: open with local app, append @path to current session draft, rename
  • Toolbar supports creating new files, new directories, and full refresh
  • Reads .git/HEAD directly via summary=branch path to display the current Git branch in the workspace sidebar summary (detached HEAD shows short commit prefix, non-Git projects don't show this line)

Technical Implementation

  • Language: TypeScript + React (TSX components)
  • Key Dependencies: @deepseek-ai/cordis, @deepseek-ai/dsh-client-runtime, @deepseek-ai/dsh-client-connection, @deepseek-ai/dsh-workspace
  • Architecture Pattern: Dual-plugin — src/index.ts registers Host-side /pilot-worktree RPC (loopback authorization), src/client/index.ts registers browser-side React component and injects into host via cordis patch
  • Entry Files: src/index.ts (Host RPC registration) / src/client/index.ts (browser component registration) / cordis.patch.yml (cordis assembly patch)

Use Cases

People who want to directly browse workspace files, reference multiple paths, or quickly create/organize project directories while chatting with AI. For example, when developers discuss code with AI and want to reference specific paths like src/auth/login.ts, or when they need to create files/directories without leaving the conversation page and immediately let AI see them.

Prerequisites & Compatibility

DependencyMinimum VersionDescription
DSH (Host)Undeclared (requires Pilot Harness v0.1.0+)Host must expose three rendering slots: conversation.session.header.utilities, shell.right-sidebar, sidebar.workspaces.session.detail
Node.js^22.19.0 || >=24.0.0From root package.json engines.node
PlatformCross-platformSource code header only references built-in modules like node:fs/promises, no os/cpu restrictions declared
Native ModulesNoneOnly uses Node built-in fs/promises, path, no native dependencies like node-pty

Installation

dsh plugin --profile web add github:op7418/pilot-harness/packages/workspace/ui-worktree

Configuration

This plugin requires no additional configuration. All interaction parameters (workspace ID, relative path, operation type) are dynamically passed through RPC requests. The source code exposes no Config fields that users can adjust in cordis.yml.

FAQ

Q: Does this plugin depend on Electron or desktop client?

A: No, it doesn't. It's a regular Web profile plugin. Browser-side and Host-side communicate via loopback-authorized Connection RPC, no Electron dependency. Native "open file" calls go through the host runtime's loopback-protected openPath route, not bypassing browser security boundaries.

Q: Can't see Files button or right sidebar after installation?

A: Upstream Harness version must support the three rendering slot contracts — conversation.session.header.utilities, shell.right-sidebar, sidebar.workspaces.session.detail. Pilot Harness v0.1.0 already includes these contracts; older Harness versions can load the plugin but cannot render the UI.

Q: Can I delete files?

A: No. Deletion is an irreversible operation. The plugin intentionally exposes only three directory operations: new file, new directory, rename. To delete files, please use system file manager or command line tools.

Q: Some files not visible in the panel?

A: The plugin actively skips .git, .DS_Store, node_modules, symbolic links, and unconventional file types (like sockets, block devices). Single directory enumeration cap is 5,000 items, Workspace root recursive count cap is 20,000 visible files — exceeding shows "truncated" instead of unlimited reading.

Q: Can I access files remotely?

A: No. RPC channel uses strict loopback authorization, no trusted-host exception. Even adding LAN origin to Harness's trustedHosts setting won't grant remote filesystem access — remote Web scenarios require a separate authentication transport layer not provided by this plugin.

Q: How to confirm successful installation?

A: After installation, restart Web profile, then run dsh --profile web --dump-config, confirm pilot-worktree entry appears in output.

Q: How to uninstall?

A: Run dsh plugin --profile web remove @deepseek-ai/dsh-ui-worktree. After restarting Web profile, the Files control in header and right sidebar will disappear together.

Q: When adding file to conversation draft, will AI really "see" this path?

A: Only appends @path text to user draft. Whether to send is determined by conversation package; plugin doesn't inject hidden model context, doesn't add tool schemas, and doesn't write Session events.

Difficulty Level

Beginner — after one installation command with no configuration, Files button appears in session header; ordinary users can directly use browsing, create, rename, and path reference.

Known Issues & Limitations

  • Workspace root recursion statistics stop after 20,000 visible files, marked as truncated count
  • Single directory enumeration stops after 5,000 items and marks as truncated, avoiding buffering entire super-large directory at once
  • Intentionally no delete operation (irreversible); currently supported directory changes only include new file, new directory, rename
  • Name validation rejects Windows reserved device names (CON/PRN/AUX/NUL/COM1-9/LPT1-9 etc.), alternate data stream syntax, names ending with dot; rename won't overwrite existing entries, target conflict reports error
  • Native title bar dragging and native directory selection box are desktop shell capabilities, pure browser combination cannot obtain
  • File RPC strictly loopback authorized, no trusted-host exception; LAN remote access not supported
  • Doesn't expose Git subdirectory details, dependency directories, platform metadata, and symbolic links
  • Older upstream Harness (missing three rendering slot contracts) can load bundle but cannot display Files control or right sidebar

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/op7418/pilot-harness/packages/workspace/ui-worktree)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory