dsh-favicon-status
Manifest valid★ 2DeepSeek Harness plugin: Session status on the browser tab — favicon badge (red failed, yellow waiting, green done, spinner running) and title prefix.
dsh-favicon-status
Shows DeepSeek Harness Session status on the browser tab, so you can tell what your agents are doing from any other tab or window.
- Favicon badge: a coloured dot on the tab icon, or a spinning ring while Sessions run.
- Title prefix: a short status in front of the page title, such as
⚠ 2 Waiting ·.
It replaces @climber47/dsh-tab-status, which crashes on DSH 0.2.x, and adds a red "broken" state.
States
| Favicon | Title prefix | When |
|---|---|---|
| 🔴 Red dot | ✕ 1 Failed · | A Session's latest turn broke (an error, DSH exiting mid-turn, or a sign-out) and you have not opened it since. Stopping a turn yourself does not count. |
| 🟡 Yellow dot | ⚠ 2 Waiting · | A Session waits on you: an approval, a question, or a plan review. |
| 🟢 Green dot | ✓ 3 Done · | A Session finished successfully while you were viewing another one. |
| 🔵 Spinning ring | ● Running · (● 3 Running · for several) | A Session or one of its subagents is running, and nothing above applies. |
| Original icon | none | Nothing to report. |
- Priority: red > yellow > green > running > idle. The most urgent state wins.
- Counts: the title always shows how many Sessions are in the winning state. The favicon dot shows a number only when there are several (up to
9+). - Clearing: open the Session. Red, yellow and green all clear the same way the sidebar dots do.
- Subagents: subagent Sessions are not counted on their own; their parent carries the status.
The DSH title (<session> — DeepSeek Harness) is kept; the prefix is layered in front of it.
Requirements
- DeepSeek Harness 0.2.2-rc.3 or later, Web UI.
- A browser that shows favicons in the tab bar. Some browsers hide favicons for pinned or grouped tabs.
Install
From the DSH Web UI: Plugins → Add plugin, then enter github:ailuvu-art/dsh-favicon-status.
From the command line:
dsh plugin --profile <your-profile> add github:ailuvu-art/dsh-favicon-status
The plugin has a server-side part, so restart dsh web if the Plugins page says a restart is required. Then refresh the browser tab.
If @climber47/dsh-tab-status is installed, turn it off first: both plugins rewrite the favicon and the title.
Language
Title words follow the DSH language setting: English, Vietnamese, and Simplified Chinese. Other languages fall back to English.
| State | English | Tiếng Việt | 简体中文 |
|---|---|---|---|
| Red | Failed | Lỗi | 出错 |
| Yellow | Waiting | Chờ bạn | 待处理 |
| Green | Done | Xong | 已完成 |
| Running | Running | Đang chạy | 进行中 |
Colours
Badge colours come from the active DSH theme's state tokens and redraw when the theme or the system light/dark mode changes:
| State | Theme token | Fallback |
|---|---|---|
| Red | --dsw-alias-state-error-primary | #e5484d |
| Yellow | --dsw-alias-state-warn-primary | #f5b301 |
| Green | --dsw-alias-state-success-primary | #30a46c |
| Running | --dsw-alias-brand-primary | #3e8cf0 |
How it works
- Server (
index.js) registers afaviconTurnOutcomeSession projection. Its value is{ seq, code }when the latest turn ended in a failure, andnullotherwise. DSH sends it to the browser over the existing Session control stream, so nothing polls. - Browser (
client.js) reads the same session list and session status the sidebar uses, picks the state, and:- replaces the favicon
<link>with a canvas-drawn PNG, putting the original links back when idle; - adds the title prefix and re-applies it, via a
MutationObserver, whenever something else rewrites the title.
- replaces the favicon
- Red acknowledgement is stored per browser in
localStorageunderdsh-favicon-status.ack.v1. The first time the plugin runs, failures that already exist count as seen, so the tab does not start out red.
Troubleshooting
- No change at all: hard-refresh the tab (Ctrl+Shift+R / Cmd+Shift+R). In Plugins, check that the
favicon-statusrow is on. Then look in the browser console fordsh-favicon-statusorslot entry crashederrors. - The red dot never clears: open the broken Session in the main view. To reset everything, run
localStorage.removeItem('dsh-favicon-status.ack.v1')in the console and refresh. - The favicon flickers between two icons: another plugin also rewrites the favicon. Turn it off.
Develop
npm run check # syntax check both halves
npm test # projection fold and state derivation (Node test runner)
There is no build step: index.js and client.js are the files DSH loads. To try local changes, install the checkout directory from Plugins → Add plugin. A linked install picks up client.js edits after a page refresh; index.js edits need a dsh web restart.
License
MIT
Comments
Loading…
From the same category
by awesome-dsh-plugin
A curated list of plugins for DeepSeek Harness (dsh) · DeepSeek Harness 插件精选列表
★ 25k
CC0-1.0
Python
Nov 17, 2026
by woniuniuniu
DeepSeek Harness 自媒体工作台插件:一句话记灵感,一键生成脚本、封面、配图和分镜
★ 1.5k
↓ 8.2k/wk
MIT
JavaScript
Nov 15, 2026
dsh plugin --profile web add dsh-media-deskby 0xsline
DeepSeek Harness (DSH) ecosystem: curated plugins, tools, and infrastructure from dsh-external/hub and the public dsh-plugin topic.
★ 1.4k
CC0-1.0
Python
Nov 6, 2026
by keli-wen
Hire Google's Antigravity CLI (agy) as a fast Gemini staffer for Claude Code, OpenAI Codex, and DeepSeek Harness.
★ 888
MIT
JavaScript
Nov 16, 2026
dsh plugin --profile agent add agy-staffby Roland0511
MarkText (muya) WYSIWYG Markdown editor for the DeepSeek Harness right sidebar
★ 762
↓ 2.8k/wk
MIT
JavaScript
Nov 7, 2026
dsh plugin --profile web add dsh-marktextby SAOS-3624
Scene-aware storyboard for DeepSeek Harness: 9-16 numbered cells with timestamps + transcript + an audio envelope, packed into ONE image (384 tokens). Two tools: video_storyboard and video_zoom.
★ 568
↓ 17k/wk
MIT
JavaScript
Nov 16, 2026
dsh plugin --profile web add dsh-video-storyboard