Back to home@WongYuYe

dsh-appshots

Codex-style Appshots for DSH Desktop: capture the frontmost macOS window and attach it to the current chat.

Stars
6
Language
JavaScript
Created
Jun 16, 2021
Updated
Sep 4, 2026

Introduction

dsh-appshots

Awesome DSH Plugin

Codex-style Appshots for DSH Desktop on macOS.

Press both Command keys (or the camera button next to the composer) to capture the frontmost window and attach it to the current chat.

  • Captures the frontmost window only, not the whole screen
  • Attaches the screenshot to the composer draft without sending it
  • Reads available window text via Accessibility and injects it as hidden model context
  • Skips DSH Desktop itself so the plugin does not capture its own window
  • After capture, brings DSH Desktop to the front

Install

dsh plugin --profile desktop add dsh-appshots

Restart DSH Desktop after installing.

From source:

git clone https://github.com/WongYuYe/dsh-appshots.git
cd dsh-appshots
dsh plugin --profile desktop add .

Permissions

System Settings → Privacy & Security:

  • Screen Recording: required to capture the frontmost window
  • Accessibility: required to listen for both Command keys and read window text

Grant these to DSH Desktop. If the hotkey does not fire, also allow appshot-capture.

Use

  1. Focus the window you want to share.
  2. Press both Command keys, or click the camera button in the composer.
  3. DSH Desktop comes to the front with the screenshot attached.
  4. Add a prompt and send.

If a session is currently open, the appshot goes there. If none is open, a new session is created. Consecutive captures go to the same session.

Settings

Namespace dsh-appshots in ~/.dsh/settings.yaml:

FieldDefaultMeaning
skipSelftrueSkip DSH Desktop itself
attachTexttrueInject cleaned window text as hidden model context on send
recentWindowMs60000If no session is open, reuse the session captured within this window
hotkeyModeboth-commandboth-command / carbon / off
carbonKeyCode0Carbon key code when hotkeyMode is carbon
carbonModifiers256Carbon modifiers; 256 is Command

Limits

  • macOS only
  • Window text comes from the Accessibility tree, so some apps expose only visible copy
  • Chrome chrome such as the tab strip and bookmark bar is filtered out of the hidden text

License

MIT