Introduction¶

When developing in the DeepSeek Harness (DSH) Work window, developers often need to switch windows frequently to confirm the current project name, branch, and change status. The omdsh-status plugin embeds the project name and Git status directly into the conversation header, to the left of the Session log export button, making this information easy to see at a glance.

Plugin Positioning¶

• Plugin name: omdsh-status
• Maintainer: omdsh-plugins
• Category: Insight
• Positioning: Displays the current project and Git status in the header of the DSH Work window conversation.

Core Features¶

1. Conversation header status display: Displays the project name and Git status in the conversation header.
2. Detailed change counts: Displays counts for the current branch, ahead/behind, staged, modified, untracked, and conflicts.
3. API endpoint: Provides the GET /omdsh-status/status endpoint.
4. No configuration required: No namespace configuration is needed; automatically reads the status of the working directory.

Installation and Enablement¶

Install using the official plugin center:

npx @omdsh-plugins/omdsh-plughub add omdsh-status

This plugin is licensed under the MIT License.

Typical Usage¶

• Session with content: Displayed on the left side of the conversation header, formatted like omdsh-plugins ⎇ main ↑1 +2 ~3.
• Blank session: When the session has not started yet, the status is displayed in the framework’s floating layer.
• Non-Git repository: If the current directory is not in a Git repository, only the project name is displayed, with a tooltip hint.

Applicable Scenarios and Limitations¶

• Chat mode: When using Chat mode (such as basemode + chatmode), the plugin does not display status because sessions in Chat mode do not belong to a specific project directory.
• Code mode: Code mode replaces the conversation panel with a terminal, and the plugin automatically hides the status display.
• Security mechanism: Git status parsing runs on the host machine and returns only count numbers; it does not send directory paths, diffs, or branch graphs to the browser.
• Polling strategy: The plugin uses an efficient polling mechanism, caches results for 2 seconds, and re-requests every 4 seconds for visible pages.

Conclusion¶

omdsh-status reduces disruptions caused by context switching by providing intuitive project and Git status in the header. For more details, refer to the plugin directory or GitHub.