dsh-node-repl
Per-session Node REPL terminal for the DSH web UI. Open a real Node.js REPL inside any conversation — with the live agent context (ctx, agent) in scope.
Features
- A REPL button in every session header opens a floating terminal window,
local to that session (no global overlay, no conversation space taken).
- A real
node:replprompt — Tab completion, up/down history, top-levelawait,
ANSI colors, .help / .editor.
- The live agent context is in scope:
ctx(=agent.ctx) andagent, so
ctx.plugin, ctx.effect, ctx.get, ctx.on, ctx.provide all work — plus the usual Node globals (require, process, console, fetch, …).
- Draggable and resizable window; collapse keeps the REPL alive, close kills it.
Install
dsh plugin --profile web add dsh-node-replRestart dsh web, and the REPL button appears in each session header.
Usage
Open a session, click REPL, and type JavaScript. Top-level await works:
> 1 + 1
2
> await Promise.resolve(42)
42
> ctx.get("webServer") // any service the agent can reach
> agent.id // the session idWindow controls
| Control | Effect |
|---|---|
Header REPL button | open / restore / collapse |
Title bar – | collapse (keep the REPL alive) |
Title bar ✕ | close (kill the REPL) |
| Drag the title bar | move the window |
| Drag the bottom-right corner | resize |
The REPL belongs to its session: refreshing the page, dropping the WebSocket, or disposing the agent kills it (reopen to start fresh).
Notes
The REPL runs inside the DSH host process (not in a child), which is how it reaches the live agent.ctx. That also makes it a fully-trusted local tool: code runs unsandboxed and can hang the process — treat it like a shell on that process.
Development
Requires pnpm and Node ≥ 22. Build outputs (lib/) are generated, not committed.
pnpm install # installs deps and builds (prepare)
pnpm build # rebuild host (tsc) + client bundle (esbuild)
pnpm test # PTY/REPL bridge smoke test
pnpm lint # eslint
pnpm format # prettier --write