dsh-cool-terminal

English · 中文

Description

DeepSeek Harness plugin that adds a Terminal tab next to Chat and Trajectory in every session — a real shell in the session workspace, right beside the conversation.

Features

• A Terminal tab beside Chat and Trajectory, with a real shell in the session workspace.
• Consoles grouped by your DSH Workspaces, plus a session-bound console when the directory is not one.
• Shell state, scrollback, and per-console command history survive tab switches and page reloads.
• Colors follow the active theme, including dsh-cool-theme presets.

Installation

The easiest way is to let DSH install it for you. For manual installation, see:

# Install
dsh plugin --profile <your-profile> add dsh-cool-terminal

# Uninstall
dsh plugin --profile <your-profile> remove dsh-cool-terminal

Replace <your-profile> with your DSH profile, e.g. web for DSH Web and desktop for DSH Desktop.

Notes

• Consoles run a real local shell as the DSH process user, not the confined one-shot shell — treat them as localhost-trusted.
• A console's geometry is fixed when it is created, because the platform's terminal primitive has no resize verb.
• Consoles are process-local and do not survive a DSH restart; one left without a browser for 15 minutes is closed automatically.
• Commands run in the selected Workspace's directory (or the session directory), and cd is remembered within one console, not across consoles.
• Command history lives in ~/.dsh-cool-terminal/history, keyed by console id. Deleting a console leaves its file behind; remove that directory to clear every console's history at once.
• The PTY provider forces every shell's terminal name to dumb, whose terminfo entry cannot move or erase the cursor. A zsh console's startup shim re-exports a real entry (xterm-256color, else xterm) so line editing, colors, and clear behave like a normal xterm; a .zshrc that sets TERM itself takes precedence.

Contributing

Contributions via Issues and PRs are welcome.

// Clone project
git clone https://github.com/CoolTea001/dsh-cool-terminal.git

// Install dependencies
cd dsh-cool-terminal
pnpm install

// Start local development
pnpm run dev

// Local install
dsh plugin --profile <your-profile> add /absolute/path/to/dsh-cool-terminal

// Restart DSH service
dsh web

License

MIT © CoolTea