dsh-jj

dsh-jj — jj (Jujutsu) 版本控制 DSH 插件

把本机 jj CLI 通过零依赖 MCP stdio server 暴露成 DSH 工具（mcp__jj__*）， 让模型在 jj 仓库里用 jj 语义做版本控制（status / log / diff / describe / new / commit / edit / abandon / undo / rebase / fetch / push / bookmark / run）， 而不是用 git 思维硬套。

前置条件

• jj ≥ 0.2x，可用 brew install jujutsu 安装（macOS）或按

官方文档 安装

• Node ≥ 18（server 零依赖，纯 stdlib）

安装

dsh plugin --profile web add github:LosEcher/dsh-jj#main

本地开发（改源码时）：

dsh plugin --profile web add link:/path/to/dsh-jj

新 bundle 安装后必须重启 dsh web（HMR 只覆盖 config 编辑）：

~/.dsh/scripts/dsh-web-restart.sh   # 或手动重启 dsh web

关于 command: jj-mcp

bundle patch 用 command: jj-mcp（包的 bin 入口）。pnpm 在安装时会把该 bin 链接到 profile 的 node_modules/.bin；若你的 dsh 进程 PATH 不含该 目录（launchd 等托管场景常见），MCP 行会 spawn 失败——此时在你的用户 patch 层用 id-targeted 配置覆盖为绝对路径：

- id: mcp-jj
  config:
    serverName: jj
    transport: stdio
    command: node
    args: ['/absolute/path/to/dsh-jj/server.mjs']
    env:
      JJ_MCP_BIN: '/path/to/jj'      # 可选
    failOnStartupError: false
    toolCallTimeoutMs: 120000

验证

# 1. 配置组合
pnpm dsh --profile web --dump-config | grep mcp-jj

# 2. 插件树 active（fiberPhase）
curl -s -X POST http://127.0.0.1:3080/api/pluginInventory/list \
  -H "Content-Type: application/json" \
  -d '{"type":"client-request","rpcId":"v1","method":"pluginInventory/list","payload":{"args":{}}}' \
  | grep -A2 'mcp-jj'

# 3. 功能：新会话里应出现 mcp__jj__* 工具（已有会话的工具 schema 快照不含新
#    MCP 工具是已知时序行为，以插件树为准）

工具（serverName jj → mcp__jj__）

工具 · 作用 · 关键参数 jj_status · 当前 change 摘要 + 工作区改动 · change (-r) jj_log · change 图（替代 git log） · limit/revset/noGraph jj_diff · 当前 change 或指定 change 的 diff · change/files jj_describe · 设置/更新描述（提交信息） · message/change jj_new · 开新空 change（无 add/commit 仪式） · message/base/insertBefore jj_commit · 封存当前 change 并开新（describe+new） · message jj_edit · 跳到已有 change 继续编辑（后代自动 rebase） · change jj_abandon · 丢弃 change（可 undo） · change/keepDescendants jj_undo · 撤销上一次 jj 操作 · — jj_rebase · 移动 change 到新父节点 · destination/source/after jj_fetch · git fetch（远程分支→bookmark） · remote jj_push · 推送 bookmark 到远程 · bookmark[]/deleted/all jj_bookmark · bookmark（=git 分支）管理 · action create/set/track/untrack/delete/move/list jj_run · 通用透传（split/workspace/op restore 等） · args[]（禁止 --config*）

所有工具支持可选 repo 参数；缺省解析顺序：repo 参数 → JJ_MCP_DEFAULT_REPO → 从 server 进程 cwd 向上找 .jj。

环境变量

变量 · 默认 · 说明 JJ_MCP_BIN · /opt/homebrew/bin/jj（不存在则 jj） · jj 二进制路径 JJ_MCP_TIMEOUT_MS · 60000 · 单次调用超时 JJ_MCP_DEFAULT_REPO · 空 · 默认仓库目录 JJ_MCP_LOG · 1 · 0 关闭 stderr 启动横幅

server 会自动探测常见 jj 安装位置；JJ_MCP_BIN 仅在自动探测失败时必要。

安全设计

• 所有工具经 spawn 数组参数调 jj，无 shell，参数注入免疫；
• jj_run 过滤 --config / --config-toml / --config-file（防通过 jj

配置项如 ui.editor 执行任意命令）；

• jj 本身所有操作可 jj undo / jj op restore，破坏性风险天然低。

独立使用（非 DSH）

server 是标准 MCP stdio server，可直接给 Claude Code / Codex 用：

npx -y jj-mcp  # 或
node /path/to/dsh-jj/server.mjs

测试

node test/test-client.mjs /path/to/a/jj/repo     # 完整冒烟套件（真实仓库）
node test/test-client.mjs --list                 # 只列工具
node test/test-client.mjs <repo> --tool jj_log --args '{"limit":5}'

测试在仓库上做 new/describe/commit/undo 等操作——用临时仓库 （jj git init /tmp/jj-test-repo），别在正式仓库上跑。