aa2246740/dsh-notch

DSH Notch is a macOS-native companion built specifically for the DeepSeek Harness desktop client, pinning real conversation status, pending questions, and unread results into a compact notch window along the screen edge. It ships as two coordinated pieces: an in-app Host plugin loaded inside DSH that syncs active sessions, background subagents, and approval prompts and writes a private connection file at $DSH_HOME/dsh-notch/runtime.json, plus a SwiftUI/AppKit/Canvas binary that renders the notch, animates elastic docking, opens the official com.deepseek.dsh desktop bundle on click, and falls back to the legacy local.dsh.desktop shell. Status is encoded as four counters — blue for running sessions, yellow for awaiting input or approval, green for unread completions, and red for failures — and idle returns to an OpenBotMotion robot that stays put when nothing else needs attention.

The intended workflow is for DSH power users running long sessions with spawned subagents and external workers from Codex, Claude Code, ACP, and the DSH SDK: install dsh-notch@0.3.4 and dsh-notch-focus@0.1.2 via the official Desktop plugin manager or dsh plugin --profile web add …, extract dsh-notch-0.3.3-macos-arm64.tar.gz, run ./dsh-notch --verify-idle-resources to confirm IDLE_RESOURCES=10/10, and then launch ./dsh-notch. Once running, clicking the notch returns to the originating conversation, answering a prompt inside the notch submits it back to the subagent, and bringing a completed session to the front in DSH clears its unread badge. Subagents, workflow tasks, and externally imported background jobs are all rolled up under their parent conversation, so the blue and green counters reflect user-facing dialogs rather than every background worker.

Prebuilt artifacts target macOS 14 on Apple Silicon only; other architectures require a source build. Building from source needs Node.js 24, Swift 6, the Xcode Command Line Tools, and, for the dsh-notch-focus companion, the dshx devkit at version 0.9.2 against a dsh-v0.2.0-rc.2 Harness checkout. First-run caveats include keeping the terminal open until idle resources verify, ensuring both the Host and the binary point at the same DSH_HOME, never launching a second instance manually while helperPath is set, and re-running npm run build plus npm run build:macos after any change to src/. The repository is MIT-licensed, only reads state without consuming model notifications, and the bundled bot assets are derived from OpenBotMotion under its retained MIT notice.