Session Bridge

Lets scripts and scheduled jobs on this Mac start, prompt, steer and read DSH sessions.

A terminal in dark mode that makes a DSH session through the bridge's socket and waits for its reply, in front of DSH's window with that session. — Drawn: the terminal shows what bash printed when it ran these commands against the bridge in this run. Behind it is DSH's window from the same run, made smaller.

A terminal in light mode that makes a DSH session through the bridge's socket and waits for its reply, in front of DSH's window with that session. — Drawn: the terminal shows what bash printed when it ran these commands against the bridge in this run. Behind it is DSH's window from the same run, made smaller.

What it does

Session Bridge is a small JSON API for the running DSH, on a Unix socket that only your user can open. Scripts, cron jobs and other agents create, prompt, steer, cancel and read sessions, and wait for a reply without polling. A session made through the bridge shows live in the DSH window, where you can take over.

A Unix socket only, mode 600: no TCP port.

Safe retries with your own request id: one session for each create, and no prompt sent twice.

Wait for the end of a turn in one call, with its reply.

Steer a running turn, or queue a follow-up.

The log records actions and sizes, never a prompt's text.

Details

VERSION0.4.0

REQUIRESNo other plugin or service.

TESTED ONmacOS

Install

FIRST, ONCE

git clone https://github.com/bertholomus/dsh-public-plugins ~/.dsh-plugins/dsh-public-plugins

THEN

dsh plugin --profile desktop add ~/.dsh-plugins/dsh-public-plugins/plugins/session-bridge

Back up your profile first. The README has the full steps and every setting.

Pictures

The Nightly test run session in DSH, with its test run open: 12 tests, all of them passing. — The session that the script made, in DSH's window, where you can read it and take over.

README ↗SOURCE ↗← ALL PLUGINS

These plugins are independent work. They are not made or endorsed by DeepSeek.

Pictures from a demo home, made by npm run showcase in dsh-public-plugins @ 3ec3465