dstask：Git 驱动的终端待办管理工具

项目简介

dstask 是一个面向个人的终端任务追踪工具，思路类似 Taskwarrior，但使用 Git 做同步，而不是专用同步协议。每个任务都可以附带完整的 Markdown 笔记，适合喜欢在终端里管理待办、并且愿意处理偶尔出现的 Git 合并冲突的用户。

它使用 Go 编写，以单个静态链接二进制文件分发，数据保存在 Git 仓库中，默认位置为 ~/.dstask。

主要功能

• 上下文系统：可自动为查询和新任务应用过滤条件与标签。
• Git 同步、撤销与冲突解决：采用 passwordstore.org 风格，不需要自建同步服务器，也方便多设备同步。
• 任务列表展示：长任务文本不会破坏列表布局。
• Markdown 笔记：使用 note 命令为每个任务编辑完整 Markdown 笔记，适合放清单。
• 打开链接：使用 open 命令在浏览器中打开任务（包括笔记）里出现的 URL。
• Shell 补全：支持 zsh、bash、Nushell，Windows 上支持 PowerShell 补全，补全内容包含当前上下文中的标签和项目。
• 导入工具：可导入 GitHub issues 或 Taskwarrior 任务。
• 单二进制：无需复杂运行时，复制可执行文件即可使用。

安装与使用

环境要求

• Git
• 支持 256 色的终端

安装

从 releases 页面下载可执行文件，放到 PATH 中的目录：

• Linux/macOS：命名为 dstask，并赋予可执行权限，例如放到 /usr/local/bin/。
• Windows：使用 dstask.exe，放到 PATH 中的目录，例如 %USERPROFILE%\bin。

首次使用前创建或克隆数据仓库：

# Linux/macOS
mkdir ~/.dstask && git -C ~/.dstask init

# Windows
mkdir %USERPROFILE%\.dstask
git -C %USERPROFILE%\.dstask init

启用 Shell 补全

Bash：

source <(dstask bash-completion)

Zsh：

dstask zsh-completion > /usr/local/share/zsh/site-functions/_dstask

Nushell：

dstask nushell-completion | save -f ~/.config/nushell/completions/dstask.nu

然后在 config.nu 中加入：

source ~/.config/nushell/completions/dstask.nu

Windows PowerShell 补全可参考项目中的 completions/powershell.ps1。

常用命令

dstask next                 # 显示最重要的任务
dstask add <任务描述>        # 添加任务
dstask note <id>            # 编辑任务笔记
dstask done <id>            # 完成任务
dstask sync                 # 通过 Git 同步
dstask context              # 设置全局上下文
dstask open <id>            # 打开任务中的 URL

添加任务时可以用 +tag 指定标签，用 project:<名称> 指定项目，用 P0 到 P3 指定优先级。例如：

dstask add fix server +work

在添加任务时，/ 之后的内容会作为笔记：

dstask add check out ipfs / https://ipfs.io

注意事项

dstask 是个人任务追踪器，不面向多人协作。如果项目涉及多人，应使用其他协作系统；dstask 仍可用于记录自己在多人项目中的工作。使用时需要熟悉 Git，并接受同步过程中可能需要手动解决合并冲突。

---

本作品整理自 GitHub 开源项目 naggie/dstask，原作者 @naggie，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。