Introduction

The Web interface of DeepSeek Harness (DSH) is conversation-based. When debugging agents, you often need to view the currently injected context documents, project directory, and repository Git status simultaneously.

dsh-compass is a DSH Web plugin, maintained by Happy2Git, licensed under MIT, Copyright (c) 2026 DeepSeek. It adds right-side context panels, a folder panel, and Git status monitoring to the Web interface, and provides session log download actions.

A note needs to be made first: the npm release version of dsh cannot display this plugin; you need to use dsh built from GitHub source code or the author’s fork.

What is this

dsh-compass is a DSH Web plugin. It places directory browsing, injected context documents, and a read-only Git commit graph into the right side of the Web interface, and provides session log download actions.

It is suitable for developers who need to verify context, files, and repository status alongside the conversation.

Core Capabilities

  • Adds right-side context panels, a folder panel, and Git status monitoring to the Web interface.
  • Directory browsing with Git status badges.
  • Real-time re-projection of injected context documents and compressed history streams.
  • Context display source tags, actual usage bars, and unread signals.
  • Read-only Git commit graph with borders and workspace status.
  • Drag files from panels into the conversation.
  • Session log download action.
  • Host route restricted to loopback.

Installation Prerequisites

Verified information indicates:

  • The npm release version of dsh cannot display this plugin.
  • Upstream master source code build (≥47f9438) is available.
  • The npm release version is unavailable.
  • The author’s fork’s default web profile already includes the same panel built-in; if switching to this package, you need to disable the built-in panel row.

Installation and Enablement

Local Clone Installation

First, clone and build the plugin:

git clone https://github.com/Happy2Git/dsh-compass.git
cd dsh-compass
pnpm install
pnpm run build

After building, return to dsh’s startup directory and install by path:

pnpm dsh plugin --profile web add /path/to/dsh-compass

This installation is tied to the clone: the checkout directory cannot be deleted or moved. After re-running pnpm run build, restart pnpm dsh web to apply the changes.

Git Installation with Pinned Commit

If you do not keep a local clone, you can use the GitHub installation method with a pinned commit:

pnpm dsh plugin --profile web add github:Happy2Git/dsh-compass#<commit-sha>

Git installation builds from source via the prepare script. pnpm ≥10 will intercept build scripts; you need to allow the build to proceed before continuing the installation.

Using a pinned commit can clarify the installation source.

Author’s Fork

The author’s fork’s default web profile already includes the same panel built-in. If switching to the dsh-compass package, you need to disable the built-in panel row.

Startup and Verification

Start or restart the Web service:

pnpm dsh web

After refreshing the page, verify that the panel appears on the right.

You can also verify that the host route is mounted by returning JSON via POST /dir/list:

POST /dir/list
Content-Type: application/json

{
  "path": "<fully-qualified-path>"
}

The request body is limited to 64 KiB and must be application/json; the path must be fully qualified.

Typical Usage

  • View files in directory browsing and view entries with Git status badges.
  • View injected context documents and compressed history streams in the context documents.
  • Use source tags, actual usage bars, and unread signals to determine context changes.
  • View the read-only commit graph with borders and workspace status in the Git panel.
  • Drag files from panels into the conversation.
  • Export logs using the session log download action.

Uninstallation

pnpm dsh plugin --profile web remove dsh-compass

Suitable Scenarios and Notes

Suitable for agent developers who use the DSH Web interface and need to view context, directory, and Git status simultaneously during development and debugging.

Notes:

  • The plugin runs with the permissions of the current dsh process; you should check the source code and MIT license before installing.
  • The npm release version of dsh cannot display this plugin; you need to use dsh built from GitHub source code or the author’s fork.
  • Upstream master source code build (≥47f9438) is available; the npm release version is unavailable.
  • Host route restricted to loopback.
  • Request body limited to 64 KiB and must be application/json; path must be fully qualified.
  • Panel is read-only: git commands never write, and dragged images are never copied to the workspace.
  • Local clone installation is tied to the clone; the checkout directory cannot be deleted or moved. Restart pnpm dsh web after rebuilding to apply the changes.
  • Git installation builds from source via the prepare script; pnpm ≥10 will intercept build scripts, requiring you to allow the build to proceed.
  • The author’s fork’s default web profile already includes the same panel built-in; switching to this package requires disabling the built-in panel row.

Conclusion

dsh-compass utilizes the right-side space of the DSH Web interface to centrally view context, files, and read-only Git status, and provides session log download actions.

Project Repository: https://github.com/Happy2Git/dsh-compass