turtle1999/turtle-ui
61Last commit Aug 13, 2026
turtle-ui DSH plugin
Turtle UI is a terminal user interface plugin for DeepSeek Harness. It is distributed as a DSH profile bundle, automatically activating a patch layer upon installation. The plugin manages terminal display and user input, while the DSH agent, model, tools, and persistence remain with the core harness.
How to install the turtle-ui DSH plugin
dsh plugin --profile tui add github:deepseek-harness/turtle-ui # fails with the allowBuilds keyCopying does not run this command. Review the repository and version before installing the turtle-ui DSH plugin.
turtle-ui DSH plugin data source
turtle-ui DSH plugin snapshot date: Aug 16, 2026
discovered
What the turtle-ui DSH plugin can do
- Provides a terminal-based UI for DeepSeek Harness
- Supports session management: create, explicitly name, and resume sessions via command-line flags
- Automatically activates its patch layer when installed as a DSH profile bundle
- Builds on the consumer's machine via a `prepare` script during installation from git
- Integrates with `@deepseek-ai/dsh-base` for durable session binding
Where the turtle-ui DSH plugin fits
- Use Turtle UI to interact with DeepSeek Harness in a terminal environment
- Manage multiple isolated sessions by specifying `--session` or `--resume` flags
- Separate the TUI layer from the core harness for cleaner profile management
- Develop and test the TUI locally with a sibling Harness checkout
Who the turtle-ui DSH plugin is for
- DSH users who prefer a terminal-based interface
- Developers contributing to or testing the DSH TUI plugin
turtle-ui DSH plugin limitations
- In-app `/resume` handoff and exit-message behavior are not yet available
- Git installation requires manual allow-builds configuration on first attempt
- Type checking requires a sibling DeepSeek Harness checkout
- Only supports terminal environments; no graphical UI
turtle-ui DSH plugin: from the repository README
Quoted from the turtle1999/turtle-ui README, the upstream source of the turtle-ui DSH plugin. Copyright remains with the original authors.
> The very first UI of dsh in a Friday afternoon This repository contains the former `packages/ui/tui` implementation, its unit and terminal snapshot tests, and a dsh profile bundle patch. The TUI owns terminal presentation and input; DeepSeek Harness owns the agent, model, tools, persistence, and `dsh` launcher. ## Development Keep this repository and DeepSeek Harness as siblings: ```text ~/git/deepseek-harness ~/git/turtle-ui ``` Install and build the sibling Harness, then Turtle UI: ```sh (cd ../deepseek-harness && pnpm install && pnpm run build) pnpm install pnpm run build ``` The peer APIs come from the sibling Harness checkout. The standalone TypeScript and Vitest configurations intentionally resolve those sources through `../deepseek-harness`; Vitest uses the Harness build for the goal host module instead of mixing that source module with transitive built packages. The patched `@earendil-works/pi-tui` is a devDependency bundled into `lib/` at build time, so consumers install no pi-tui and need no `patchedDependencies`. ## Run Turtle UI is a dsh profile bundle: its `package.json` declares `"dsh": { "bundle": { "patch": "./cordis.patch.yml" } }`, so installing it into
Read the full READMERepository license: BSD-3-Clause
turtle-ui DSH plugin questions
How do I install Turtle UI from a local checkout?
First, keep Turtle UI and DeepSeek Harness as sibling directories (e.g., ~/git/deepseek-harness and ~/git/turtle-ui). Build the sibling Harness with `(cd ../deepseek-harness && pnpm install && pnpm run build)`, then in the turtle-ui directory run `pnpm install && pnpm run build`. Finally, add it to a profile: `dsh plugin --profile tui add file:.` and launch with `dsh --profile tui`.
How do I install Turtle UI directly from GitHub?
Run `dsh plugin --profile tui add github:deepseek-harness/turtle-ui`. The first attempt will fail because pnpm ≥10 blocks the build script. pnpm will print an `allowBuilds` key; copy that key into the profile's `pnpm-workspace.yaml` file (located at ~/.dsh/profiles/tui/pnpm-workspace.yaml). Then re-run the same `add` command, and it will build and activate.
How do I create a new session with a specific ID?
Use the `--session` flag followed by an ID. For example: `dsh --profile tui --session my-session`. This creates a fresh session with that explicit name. If you don't provide `--session`, a fresh session ID is generated automatically on every launch.
How do I resume a previous session?
Use the `--resume` flag followed by the session ID. For example: `dsh --profile tui --resume my-session`. This will continue the persisted session. Note that in-app `/resume` handoff is not yet available, so you must use the command line.
Why does `dsh plugin add` from git fail with an allowBuilds error?
The plugin uses a `prepare` script that runs during installation to transpile the lib/ directory. pnpm 10 and later block such scripts by default for security. The error message will include an `allowBuilds` key that you need to add to the profile's `pnpm-workspace.yaml` file. After adding it, re-run the same `dsh plugin add` command and the build will proceed.