task-passport DSH plugin

Task Passport is a plugin for DeepSeek Harness that manages persistent task state with versioning, locking, and conflict detection. It enables tasks to be transferred between different AI harnesses via a self-contained TaskPack file, preserving only verified facts and next steps.

skills-workflows

How to install the task-passport DSH plugin

dsh plugin --profile web add task-passport@0.3.0

Copying does not run this command. Review the repository and version before installing the task-passport DSH plugin.

task-passport DSH plugin data source

task-passport DSH plugin snapshot date: Aug 16, 2026

discovered

What the task-passport DSH plugin can do

Assign each task a stable short ID like TP-7K4M-9D2Q
List, open, checkpoint, pack, and land tasks across sessions and machines
Use U-King Action Core, local directory, or third-party providers as storage backends
Provide MCP tools for Claude Code and Codex: task_passport_list, open, new, checkpoint, pack, land, conformance
Enforce hard rules: facts are demarked as unverified on pack, asks require acceptance criteria, and pack files contain data not instructions
Support flat JSON output for recipients without any tools installed

Where the task-passport DSH plugin fits

Hand off a complex task from a DeepSeek Harness session to a Claude Code session without losing context
Share a task with a colleague who uses a different AI harness, using a single TaskPack file
Maintain a long-running task across multiple sessions and machines, with version conflict detection
Integrate task state into a custom dashboard via the provider contract

Who the task-passport DSH plugin is for

Developers and power users who frequently switch between AI coding assistants and need to preserve task progress
Teams collaborating on AI-assisted tasks across different harnesses (e.g., DeepSeek Harness, Claude Code, Codex)

task-passport DSH plugin limitations

Does not copy AI chat logs or previous conversation history — only verified facts and next steps are transferred
Requires Node.js 20+ and npm for installation via npx
U-King provider is optional but default; without it, local directory storage must be configured
Network access to npm registry may be unreliable in China; mirror registry is recommended
Does not automatically detect which task was recently modified — user must specify the passport ID
Long task text is not stored in the passport; only paths/URLs and revision hashes are recorded

task-passport DSH plugin: from the repository README

Quoted from the dongsheng123132/task-passport README, the upstream source of the task-passport DSH plugin. Copyright remains with the original authors.

让一个任务带着“当前世界状态”在 DeepSeek Harness、Claude Code、Codex 等 AI Harness 之间接力，不搬运聊天记录。 > **护照留在家里，TaskPack 出门。** > Task Passport 是常驻的任务状态（有版本、有锁、留在 store 里）； > **TaskPack** 是一次搬运的封装（单文件、自包含、在别人机器上打开）。 > `护照 --pack--> TaskPack --land--> 新护照` 一个项目可以有多个任务护照；一个任务护照可以经历多个 Harness 和多个会话。 ## 现在能做什么 - 每个任务一个稳定短号，例如 `TP-7K4M-9D2Q`。 - `list`：只列身份与摘要，不误装载别的任务。 - `open`：读取目标、当前状态、验证过的事实、决策理由和下一步。 - `checkpoint`：工作完成后写回；带状态版本，过期写入直接冲突，不静默覆盖。 - `pack` / `land`：把任务装进一个文件发给别人、发给另一台机器，或者收下别人发来的。 - `conformance`：判定一个文件是不是合规的 TaskPack（退出码 0 / 2）。 - 同一个包既是通用 CLI，也是 DeepSeek Harness 原生 bundle。 - 状态可由 U-King Action Core、本地目录参考存储或第三方 Provider 托管；插件本身是可装可卸的薄适配器。它不做两件事：不复制上一位 AI 的聊天记录；不把“刚改过的任务”猜成当前任务。 ## 跨机跨人：TaskPack 规范正本：[`docs/taskpack-0.1.md`](docs/taskpack-0.1.md) · <https://taskpack.org> ```sh # 发出去（对方装了工具，走标准形态） task-passport pack TP-7K4M-9D2Q --out 交接.taskpack --actor 贺方升 \ --file ./01-文案.txt \ --ask "给封面图的提示词|一段中文提示词，覆盖 750×400 与配色要求" \ --check "本机能出图|bl image generate 跑一张测试图" # 发出去（对方什么都没装 —— 一个可读 JSON，丢给他自己的 AI 就行） task-passport pack TP-7K4M-9D2Q --out 交接.taskpack.json --flat # 收下来 task-passport land 交接.taskpack --store D:\TaskPassports task-passport conformance 交接.taskpack ``` 三条硬规矩，

Read the full READMERepository license: MIT

task-passport DSH plugin questions

Is Task Passport compatible with Claude Code and Codex?

Yes, Task Passport provides MCP tools for both Claude Code and Codex. You can install via `claude mcp add --scope user task-passport -- npx --yes task-passport@0.3.0 mcp` and similarly for Codex. After installation, you get seven tools: task_passport_list, open, new, checkpoint, pack, land, and conformance.

How do I install Task Passport as a DeepSeek Harness plugin?

Run `dsh plugin --profile web add task-passport@0.3.0` to install the plugin. Then use `dsh web` to start the web interface. You may need to configure storage backend in `cordis.patch.yml` if you are not using U-King.

Can I use Task Passport without U-King?

Yes, starting from v0.3.0, Task Passport supports a local directory storage backend. Set `TASK_PASSPORT_STORE` environment variable or use `--store` flag to point to a directory. All harnesses on the same machine can share the same directory to read/write the same passports.

What is the difference between Passport and TaskPack?

Task Passport is the persistent state that stays in the store (like a database). TaskPack is a portable file that packages a passport's state for transfer. You use `pack` to create a TaskPack file and `land` to import it into a new store. The TaskPack contains only data (no instructions) and demotes machine-level facts to unverified.

How does conflict detection work?

Each passport has a version number. When you checkpoint, you must provide the expected version. If the passport has been updated by another session since you last read it, the save will be rejected with a conflict error. This prevents silent overwrites. The same mechanism works across local directory storage and U-King.