dsh-grok-tui

KO | EN

gitlite — search

#javascript #python #ai #typescript #golang #go #docker #macos #awesome #kubernetes #awesome-list #security #pytorch #openai

(★ 10)

Use dsh via grok-build's TUI.

dsh-grok-tui 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# dsh-grok-tui

把 [grok-build](https://github.com/xai-org/grok-build) 的 TUI 作为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 的前端：界面是 grok 的，内核（提示词、工具、模型路由、会话持久化）由 dsh 提供。

Grok's TUI as a frontend for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh): the interface is grok's, the engine (prompts, tools, model routing, persistence) is dsh's.

![dsh-grok-tui](https://raw.githubusercontent.com/chen-001/dsh-grok-tui/main/image.png)

## 安装 / Installation

前提：已安装 [dsh](https://github.com/deepseek-ai/deepseek-harness) 与 grok TUI 二进制（`curl -fsSL https://x.ai/cli/install.sh | bash`）。支持 macOS / Linux。

Prerequisites: [dsh](https://github.com/deepseek-ai/deepseek-harness) and the grok TUI binary (`curl -fsSL https://x.ai/cli/install.sh | bash`). macOS / Linux.

### 方式 A：npm 发布版 / Published npm package

```sh
npm install -g dsh-grok-tui
grok-dsh setup        # 把 grok bridge 挂进 dsh web 的 profile（幂等，可重复执行）
                      # wire the grok bridge into the dsh web profile (idempotent)
npx @deepseek-ai/dsh web   # 启动官方 host / start the official host
grok-dsh              # 打开 TUI，直连运行中的 dsh web
                      # open the TUI, bridging to the running dsh web
```

`grok-dsh setup` 是显式的（npm 全局安装不会静默改写你的 dsh 配置）：它把 grok-server 行写进 `~/.dsh/profiles/web/cordis.patch.yml` 并把插件软链进 profile 的 node_modules，`npx @deepseek-ai/dsh web` 随之携带 leader socket。host 已在运行时重装后需重启一次。

`grok-dsh setup` is explicit (a global install never silently rewrites your dsh config): it adds the grok-server row to `~/.dsh/profiles/web/cordis.patch.yml` and links the plugin into the profile's node_modules, so `npx @deepseek-ai/dsh web` carries the leader socket. Restart the host once if it is already running.

### 方式 B：git 完整安装 / Full installer

```sh
git clone https://github.com/chen-001/dsh-grok-tui.git
cd dsh-grok-tui && sh install.sh
```

This installer performs the same bridge hookup automatically, then builds and writes the `grok-dsh` launcher into your PATH.

两种方式安装后的行为完全一致（命令、herdr 侧栏自动配置、用量面板）。

Both paths behave identically afterwards (command, automatic herdr sidebar config, usage panels).

## 使用 / Usage

先启动官方 host（推荐），再打开 TUI：

Start the official host first (recommended), then open the TUI:

```sh
dsh web                # 启动官方 host / start the official host
grok-dsh               # 打开 TUI：检测到运行中的 dsh web 则直连，否则启动本窗口独立后端
                       # open the TUI: bridges to a running dsh web, else starts a per-window backend
grok-dsh stop          # 停止所有独立后端 / stop all standalone backends
grok-dsh status        # 查看 host 桥 / 独立后端状态与 grok 版本 / host bridge & backend status, grok version
grok-dsh restart       # 重启当前窗口的独立后端 / restart this window's standalone backend
```

在哪个目录运行 `grok-dsh`，会话的工作目录就在哪个目录。独立后端与 `dsh web` 不要同时运行（两者写同一会话存储）。

Run `grok-dsh` in the directory you want the session's working directory to be. Do not run a standalone backend while `dsh web` is up (both write the same session store).

## 用量指标展示 / Usage metrics

官方 grok 二进制即可显示 token 用量（状态栏 `18K/1.0M` context bar）。完整指标——缓存命中率、TTFT、TPS、输入/输出 token——在以下环境自动展示，**无需编译任何 grok 源码**：

The stock grok binary already shows token usage (the `18K/1.0M` context bar). Full metrics — cache hit rate, TTFT, TPS, in/out tokens — appear automatically in these environments, **no grok source build needed**:

### 推荐：在 herdr 中使用 / Recommended: inside herdr

在 [herdr](https://github.com/herdrdev/herdr) 的 pane 里运行 `grok-dsh`，指标实时显示在左侧 agents 列表的 grok 条目下（herdr 侧栏配置由安装自动完成，重启 herdr 或 reload config 后生效）：

Run `grok-dsh` inside a [herdr](https://github.com/herdrdev/herdr) pane and the metrics appear live under the grok entry in the agents list (herdr sidebar config is installed automatically; reload herdr or its config to pick it up):

| token | 内容 / Metric | 示例 / Example |
|---|---|---|
| `dsh_cache` | 缓存命中率 / cache hit rate | `99.6%` |
| `dsh_ttft` | 平均首 token 延迟 / avg time-to-first-token | `0.8s` |
| `dsh_tps` | 平均输出速率 / avg output tokens/s | `204.1/s` |
| `dsh_in` / `dsh_out` | 累计输入/输出 token / cumulative in/out tokens | `64` / `175` |

### 在 tmux 中使用 / Inside tmux

在 tmux 里运行 `grok-dsh` 会自动在 TUI 下方开一个用量面板窗格（按 `q` 关闭）：

Running inside tmux auto-opens a usage panel below the TUI (press `q` to close):

```
╭─ dsh usage ─────────────────────╮
│ cache hit     99.6%  (18.0K read) │
│ input            64 tokens       │
│ output          172 tokens       │
│ total         18.1K tokens       │
│ api calls           1            │
│ tool time        0.0s            │
╰─────────────────────────────────╯
```

dsh-grok-tui

dsh-grok-tui 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

dsh-grok-tui

dsh-grok-tui 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README