@asun-labs/dsh-plugin-agent-switch
Agent Switch：面向 DeepSeek Harness 的 Codex 委派卡片和停靠式 CLI 输出
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @asun-labs/dsh-plugin-agent-switch@0.3.1Plugin Agent Switch 以 @asun-labs/dsh-plugin-agent-switch 发布，当前版本为 0.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Install the Agent Switch plugin as @asun-labs/dsh-plugin-agent-switch. Existing users can follow the upgrade guide; saved settings and terminal output are imported automatically on first launch.
@asun-labs/dsh-plugin-agent-switch connects Codex child tasks to a DeepSeek Harness conversation. A model-facing tool launches parallel Codex CLI processes through agent-switch, renders a live task card in the conversation, and opens their terminal output in the native right sidebar. The manual multi-CLI runtime panel is also available as a native right-sidebar tab.
agent_switch_delegate with one child card per Codex task^22.19.0 or >=24.0.00.1.5 or 0.1.7 client slot and connection APIsagent-switch installed on the Host PATH (agent-switch --help)The plugin includes the node-pty native dependency. Its install script must be allowed to run so interactive terminals work. This implementation is developed and tested on Windows; macOS and Linux use the same node-pty API but still need platform validation.
Initialize a DSH profile if needed, then install the npm package:
dsh --profile agent-switch --from-default-profile web --dump-config | Out-Null
dsh plugin --profile agent-switch add @asun-labs/dsh-plugin-agent-switch
dsh --profile agent-switch --no-open
node-pty needs to run its native install script. If DSH reports that pnpm blocked the node-pty build, open the Web plugin page, review the named script, and use Allow these scripts and retry for that profile. The permission is recorded in that profile's allowBuilds setting.
Open the right sidebar's Agent Switch Panel tab, choose a runtime, and switch between Grid and Tabs in the panel header. Switching to another right-sidebar tab keeps its CLI sessions running; close a terminal explicitly to stop it.
To use Agent Switch, ask the Seal Harness/DSH assistant: “Use Agent Switch to delegate these tasks to Codex.” It calls agent_switch_delegate, which creates the conversation card. Click a child card to open the corresponding terminal output in the native right sidebar. The right sidebar's guide also opens Agent Switch's recent task groups for history playback.
Build this package with Node 22.19+ or 24+:
corepack pnpm install
corepack pnpm run check
Initialize a DSH profile if needed, then install the package by absolute path:
dsh --profile agent-switch --from-default-profile web --dump-config | Out-Null
dsh plugin --profile agent-switch add <absolute-path-to-dsh-plugin-agent-switch>
dsh --profile agent-switch --dump-config
dsh --profile agent-switch --no-open
config:
workspace: '' # empty uses the DSH Host working directory
maxSessions: 9 # 1–32
defaultModel: '' # empty uses the Codex CLI default
codexProfile: '' # empty uses the current Codex account
codexAccountId: '' # saved agent-switch account id when a profile is selected
historyDays: 30 # show groups from the last 1–365 days
Manual terminals use the Host plugin's configured working directory. Delegated Codex tasks use their parent DSH session's workspace when available, falling back to that Host directory. Browser requests cannot choose an arbitrary working directory or command; only the six fixed provider names are accepted. The settings page saves the Codex profile, selected saved-account ID, and model for new delegated tasks. It lists account labels from Agent Switch's local index but does not read or display authentication secrets. An independent Codex profile needs a saved account selected before it can run unattended.
src/index.ts registers the model-facing tool and authenticated Host routes through DSH Connection. src/delegation.ts keys each task group by the DSH tool call ID and stores its metadata and terminal output under $DSH_HOME/agent-switch/; completed output remains viewable after restart. src/client-extras.tsx contributes the settings section, keyed tool card, and native right-sidebar tabs. src/client.tsx provides the manual runtime panel and src/sessions.ts manages its interactive PTYs.
The shell's output and captured model conversations can contain sensitive material. The agent-switch CLI stores model captures in its normal local store; this plugin also keeps delegated terminal output locally for history playback. It does not upload logs or add telemetry. A Host restart ends running processes; saved output can be reviewed, but the original PTY process cannot be resumed.
This plugin adapts the panel behavior from OpenAgentSeal. See NOTICE and LICENSE. The terminal stylesheet comes from xterm.js under the MIT License.