# @ai-eks/dsh-docking-layout

English | [中文](README.zh.md)

A DeepSeek Harness Web UI plugin for organizing unlimited conversation tabs into editor-style groups. Split freely, then close or move tabs whenever a pane becomes too small.

## Preview

![Unlimited conversation tabs](docs/images/unlimited-tabs.png)

| Two groups | Three groups |
| --- | --- |
| ![Two conversation groups](docs/images/two-groups.png) | ![Three conversation groups](docs/images/three-groups.png) |

## Features

- Unlimited tabs and groups, with no fixed pane-size guard.
- Drag a tab to another group to move it, or to an edge to split; toolbar buttons split right or down.
- At widths up to 760 pixels, one full-width group is shown at a time with a group switcher.
- Switching to single-column mode hides the docked panes; reopening Docking Layout restores the groups.
- Closing a tab changes only the browser layout and never deletes its DSH Session. Closing the final tab opens a blank Session, reusing an existing blank Session when DSH selects one.

## Install

From npm:

```sh
dsh plugin --profile web add @ai-eks/dsh-docking-layout@latest
```

From Git:

```sh
dsh plugin --profile web add github:ai-eks/dsh-docking-layout
```

From a local checkout:

```sh
git clone https://github.com/ai-eks/dsh-docking-layout.git
cd dsh-docking-layout
pnpm install
dsh plugin --profile web add .
```

Remove the plugin with:

```sh
dsh plugin --profile web remove @ai-eks/dsh-docking-layout
```

Enable Docking Layout from the DSH sidebar footer. Open Sessions from the group menu or the DSH sidebar, then drag tabs or use the split buttons to arrange them.

## Performance and limitations

The iframe pool keeps every group's active tab plus the two most recently used inactive tabs mounted. Revisiting an evicted tab reloads its embedded client. More groups therefore use more browser memory and DSH Web connections.

The global details panel and companion plugins still follow the outer DSH Session. Archived Sessions and subagent routes use the native conversation view. Touch layouts use split buttons and the group switcher instead of tab dragging.

Only layout preferences are stored locally. The plugin does not copy Session logs, prompts, approvals, or files, and all embedded pages are same-origin. It adds no model-visible prompts, tools, messages, or Session events.

## Compatibility

Requires DeepSeek Harness `^0.1.2-rc.1` and Cordis `^4.0.2`. Earlier DSH releases do not provide the required client store and controller packages. Compatible with `dsh-better-sidebar`.

## Development

```sh
pnpm install
pnpm typecheck
pnpm test
pnpm build
```