JingleNotch

AI Agent Approval Notifier for DeepSeek Harness
鲸铃 Jingle · macOS notch companion

GitHub · npm · 中文

JingleNotch keeps the moments that need your decision visible while an AI agent works. When DeepSeek Harness pauses for tool approval, a plan review or a structured question, 鲸铃 Jingle brings the request to the macOS notch and lets you respond without leaving your workspace.

It runs with DeepSeek Harness Desktop and Web. The same request controls are available in a focused browser dashboard.

Quick start

With DeepSeek Harness installed, add the plugin from npm to the profile you use.

macOS Desktop

Open DeepSeek Harness once to initialize it, then fully quit the application. Run:

'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' \
  plugin --profile desktop add dsh-jingle-notch

Reopen the app and enter /jingle overlay in a session to open the notch companion.

Web

dsh plugin --profile web add dsh-jingle-notch
dsh web

Enter /jingle overlay in a session to open the overlay, or visit /jingle at your Harness server address for the browser panel. Restart an existing Web server after installation.

Desktop and Web use separate profiles; install into each one you use. The native overlay requires macOS and Electron. First launch can download Electron through npm and needs Node/npm and network access. You can also configure an existing Electron executable; see installation.

Plugin features

• Approval at a glance — review a tool, then choose Allow once, Deny or Always in this session.
• Complete plan review — read the full plan and its exact approval choices before the agent continues.
• Structured questions — answer single choice, multiple choice and free text questions in one form; drafts survive polling.
• Multi-session awareness — follow active sessions, current tools, workspaces and parallel calls from one compact notch view.
• Actionable file activity — inspect bounded before/after previews with added and removed line counts.
• Native macOS notch UI — hover for an overview, expand for details, scroll through sessions and keep the panel available for new requests.
• Browser dashboard — answer approvals and questions from /jingle when a browser view is more convenient.
• Local operation — bundled artwork, no additional model requests and no added telemetry service. Recap history stores numeric aggregates only; see configuration for privacy and notification controls.
• Chimes and system notifications — get alerts for approvals, questions and completed turns, with separate switches and custom audio support.
• Jingle character states — bundled animation responds to idle, thinking, working, attention, finished and error states, including reduced-motion posters.

See JingleNotch in action

The screenshots use synthetic sessions. The original Jingle animations ship in the package and work offline.

Compatibility

Host	Verified release	Coverage
Official macOS Desktop	0.2.1-rc.5	Bundled CLI installation, packaged Host and native overlay
Released Web	0.2.1-rc.5	Web profile, dashboard and native overlay
Source Web	0.2.2-alpha.2	Built source Host, dashboard and native overlay

The plugin declares compatibility with 0.2.1-rc.5 and 0.2.2-alpha.2. The native overlay requires macOS, a graphical session and an Electron executable. See installation for Electron configuration and local package installation.

Commands and configuration

/jingle                  Show session status
/jingle overlay          Open the native notch overlay
/jingle overlay stop     Close the overlay while Harness keeps running

The profile patch row is jingle-notch. Full configuration options, storage locations and privacy controls are documented in configuration. Development and verification covers tests, packaging and the Desktop/Web matrix.

Development

pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
npm pack --dry-run

Feedback and contributions

Report bugs and suggest features in Issues, or send a pull request. Include your macOS, Harness and plugin versions, Desktop/Web profile and reproduction steps. Remove sensitive content from logs and screenshots. See the development guide for builds, tests and packaging.

License and acknowledgements

JingleNotch is released under the MIT License. Third-party copyright and permission notices are included in THIRD_PARTY_NOTICES.md. Built for DeepSeek Harness, with package presentation references from dsh-pet and dsh-market. 鲸铃 Jingle artwork was supplied by the project author; its checksums and source files are documented in asset provenance.