Skip to content
  • Home
  • Plugin manual
  • dsh-session-hub

Asaiuta/dsh-session-hub

41Last commit Aug 15, 2026

dsh-session-hub DSH plugin

This plugin merges sessions from remote DSH instances into your local workspace tree, allowing you to manage them as if they were local. It also can import past conversations from Codex CLI, Claude Code, opencode, and Pi, displayed as read-only sessions. The plugin only moves data, not UI, so the official Web UI remains unchanged.

remote-executiondeveloper-tools

How to install the dsh-session-hub DSH plugin

dsh plugin --profile web add dsh-session-hub@alpha

Copying does not run this command. Review the repository and version before installing the dsh-session-hub DSH plugin.

dsh-session-hub DSH plugin data source

dsh-session-hub DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-session-hub DSH plugin can do

  • Connect to remote DSH instances via SSH tunnel and display their sessions as groups in the workspace tree.
  • Import historical sessions from Codex CLI, Claude Code, opencode, and Pi, arranged by project.
  • Remote sessions persist independently; closing the local machine does not stop remote agent loops.
  • Model configuration sync: copy missing providers and API keys from local to remote servers.
  • Read-only imported sessions can be converted to real DSH sessions by sending a message.

Where the dsh-session-hub DSH plugin fits

  • Manage multiple remote servers' DSH sessions from a single Web UI.
  • View and search past conversations from different AI tools in one place.
  • Keep a remote agent running on a server while you disconnect and reconnect later.
  • Onboard a new team member by sharing server configuration.

Who the dsh-session-hub DSH plugin is for

  • DSH users who work with remote servers and need to access their sessions locally.
  • Developers who use multiple AI coding assistants (Codex, Claude Code, opencode) and want to unify their chat history.

dsh-session-hub DSH plugin limitations

  • Alpha quality: only tested on one environment (Windows local + Tencent Cloud Linux via SSH tunnel); configuration format may change before 1.0.
  • Only works with the `web` profile; not compatible with `headless` or `tui`.
  • Remote servers must run `dsh web`; cannot connect to a server without DSH installed.
  • Requires Node.js ^22.19 || >=24.
  • May conflict with other plugins that intercept the same `/api` routes (e.g., `/api/respond`).

dsh-session-hub DSH plugin: from the repository README

Quoted from the Asaiuta/dsh-session-hub README, the upstream source of the dsh-session-hub DSH plugin. Copyright remains with the original authors.

**把散在各处的会话收进 DSH 的同一棵树。** 远端服务器上的 DSH 会话，本机 Codex CLI、Claude Code、opencode、Pi 的历史对话， 一起进官方 Web UI。侧边栏和对话区都用官方的，插件只搬数据。两件事互相独立，可以只装一件。 <a href="https://www.npmjs.com/package/dsh-session-hub"><img alt="npm" src="https://img.shields.io/npm/v/dsh-session-hub/alpha?style=flat-square&color=4b6fff"></a> <a href="LICENSE"><img alt="MIT" src="https://img.shields.io/badge/license-MIT-blue?style=flat-square"></a> <a href="CHANGELOG.md"><img alt="changelog" src="https://img.shields.io/badge/changelog-alpha.2-8957e5?style=flat-square"></a> <img alt="alpha" src="https://img.shields.io/badge/status-alpha-orange?style=flat-square"> <img alt="node" src="https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-3c873a?style=flat-square"> <img alt="DSH" src="https://img.shields.io/badge/DSH-0.1.0--rc.6-4b6fff?style=flat-square"> </div> > [!WARNING] > Alpha 版本（`0.1.0-alpha.2`，[本版改动](CHANGELOG.md)）。核心链路都在真机上跑通过：网关路由、官方 UI 桥接、 > 实时帧注入、审批应答、跨机对话。但只验证过一套环境（Windows 本机 + 腾讯云 Linux，SSH 隧道）， > 配置格式和安全边界在 1.0 前仍可能变。 ## 这是什么 DSH 的会话树只认这一台机器、这一个工具产生的会话。于是： 服务器上跑了一半的任务，要开新标签页、连隧道、从头找起。关掉笔记本再回来，不知道它现在到哪一步。 上周用 Codex CLI 聊过的方案，在 DSH 里根本不存在，只能去翻 `~/.codex` 底下的 JSONL。 这个插件把这两类会话都接进同一棵树： <!-- 截图占位：侧边栏（服务

Read the full READMERepository license: MIT

dsh-session-hub DSH plugin questions

How do I install dsh-session-hub?

Run `dsh plugin --profile web add dsh-session-hub@alpha` in your terminal. Then restart `dsh web` (use `kill -TERM <pid>` and wait for it to exit; do not use `kill -9`). Refresh the browser, and the plugin will appear in Settings → Plugins.

How do I import sessions from Codex CLI?

Open Settings → Plugins → Session Hub → External Sessions. Click the 'Import' button for Codex CLI. You can also enable auto-scan to periodically check for new logs. Imported sessions appear as read-only in the workspace tree.

How do I connect a remote server?

Go to Settings → Plugins → Session Hub → Add Server. Fill in the name, host, SSH user, and private key path. Click 'Test' to verify the connection, then 'Add'. The plugin will automatically establish an SSH tunnel. Remote DSH sessions will appear as a group in your workspace tree.

Does this plugin replace the DSH Web UI?

No. It only merges session data. The sidebar, conversation area, and all UI components remain unchanged. Other UI plugins can coexist. The plugin adds a single tab in the settings page but does not shadow any UI slots.

What files does the plugin read?

It reads its own configuration files in `$DSH_HOME/plugins/`. For importing, it only reads session logs from tools you explicitly enable (e.g., `~/.codex/sessions/`). It never writes to those logs. For remote servers, it reads SSH private key files only if you provide a path; otherwise it uses the ssh agent.