harveyz-skill 0.13.0 → 0.14.1

package/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.14.1] - 2026-06-14
+
+### Fixed
+- `hub` 安装失败（`source_not_found`）：新增 `hub.sh` 启动脚本，安装器现在能正确找到 hub 入口
+- `hub` tool.json `extraPaths` 路径错误（`core/cli` 不在工具根目录），修正为 `["hub", "pyproject.toml"]`
+- `hub` 卸载后遗留 `~/.hskill/tools/hub/` Python 源码目录，将其加入 `uninstallPaths`
+- hskill 交互流程次级 fzf 页面（action/target/scope）缺少 preview 面板，视觉风格与主列表页不一致
+
+### Added
+- `docs/how-to/use-hub.md`：hub 人用操作指南（安装、TUI、projects/tasks 常用命令）
+- `docs/reference/hub-reference.md`：hub CLI 完整参考（供 agent 调用，含 JSON 输出格式）
+
+## [0.14.0] - 2026-06-14
+
+### Added
+- `hub` tool（`tools` bundle）：个人开发者 OS，整合项目管理、git 状态追踪、任务系统，替代 p-launch + todo-tool
+  - Phase 1：core 库（SQLite DB、projects CRUD、tasks CRUD）+ CLI（`hub project`、`hub task` 子命令，支持 `--json` 输出）
+  - Phase 2：三栏 Textual TUI（ProjectsPanel | GitPanel | TasksPanel），支持键盘导航、git fetch、任务增删改、项目切换联动
+  - 首次启动自动从 todo-tool DB 迁移数据（`migrate.py`）
+  - 62 个测试覆盖 core、CLI、TUI 各层
+
 ## [0.13.0] - 2026-06-12
 
 ### Fixed

package/bin/cli.js

@@ -2,7 +2,7 @@
 import { select, input } from '@inquirer/prompts'
 import chalk from 'chalk'
 import { execSync, spawnSync } from 'child_process'
-import { existsSync } from 'fs'
+import { existsSync, writeFileSync, unlinkSync } from 'fs'
 import { createRequire } from 'module'
 import os from 'os'
 import path from 'path'
@@ -629,6 +629,8 @@ function selectTargetThenScope() {
     '--layout=reverse',
     '--border=rounded',
     '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+    '--preview=t=$(echo {} | awk \'{print $1}\'); if [ "$t" = "all" ]; then echo ""; echo "  安装到所有平台:"; echo ""; for p in claude cursor codex openclaw hermes opencode; do printf "  ~/.%s/skills/\\n" "$p"; done; else p="${HOME}/.${t}/skills/"; echo ""; echo "  安装路径:"; echo ""; printf "  \\033[36m%s\\033[0m\\n" "$p"; echo ""; if [ -d "$p" ]; then echo "  ✓ 目录已存在"; else echo "  · 将自动新建"; fi; fi',
+    '--preview-window=right:45%:wrap',
   ], {
     input: targetInput,
     encoding: 'utf8',
@@ -651,6 +653,8 @@ function selectTargetThenScope() {
       '--layout=reverse',
       '--border=rounded',
       '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+      '--preview=s=$(echo {} | awk \'{print $1}\'); if [ "$s" = "user" ]; then echo ""; echo "  ~/.{target}/skills/"; echo ""; echo "  所有项目共享，适合常用 skill"; echo ""; echo "  ✓ 推荐选项"; else echo ""; echo "  .{target}/skills/"; echo ""; echo "  仅当前项目可见"; echo ""; echo "  适合项目专属 skill"; fi',
+      '--preview-window=right:45%:wrap',
     ], {
       input: 'user     — 所有项目共享  (~/.{target}/skills/)\nproject  — 仅当前项目  (.{target}/skills/)',
       encoding: 'utf8',
@@ -898,17 +902,30 @@ try {
           })
 
         if (anyInstalled) {
+          const actionPreviewFile = `/tmp/hskill-action-preview-${process.pid}.txt`
+          const actionPreviewLines = [
+            '',
+            '  已选中:',
+            '',
+            ...skillItems.map(s => `  skill  ${s.skillName}`),
+            ...toolItems.map(t => `  tool   ${t.toolName}`),
+            ...hookItems.map(h => `  hook   ${h.name}`),
+          ]
+          writeFileSync(actionPreviewFile, actionPreviewLines.join('\n'))
           const actionResult = spawnSync('fzf', [
             '--prompt=  › ',
             '--header=  Action  ·  enter 确认  ·  esc 取消',
             '--layout=reverse',
             '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+            `--preview=cat ${actionPreviewFile}`,
+            '--preview-window=right:45%:wrap',
           ], {
             input: `install    安装 / 重新安装\nuninstall  卸载并清理文件`,
             encoding: 'utf8',
             stdio: ['pipe', 'pipe', 'inherit'],
           })
+          try { unlinkSync(actionPreviewFile) } catch { /* ignore */ }
           if (!actionResult.stdout.trim()) {
             console.log(chalk.dim('  · Cancelled'))
             break
@@ -964,6 +981,8 @@ try {
             '--layout=reverse',
             '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+            '--preview=s=$(echo {} | awk \'{print $1}\'); if [ "$s" = "user" ]; then echo ""; echo "  ~/.claude/hooks/"; echo "  ~/.codex/hooks/"; echo ""; echo "  所有项目共享"; else echo ""; echo "  .claude/hooks/"; echo "  .codex/hooks/"; echo ""; echo "  仅当前项目"; fi',
+            '--preview-window=right:45%:wrap',
           ], {
             input: `user     — ~/.{claude,codex}/hooks/  (所有项目共享)\nproject  — .{claude,codex}/hooks/    (仅当前项目)`,
             encoding: 'utf8',
@@ -983,6 +1002,8 @@ try {
             '--layout=reverse',
             '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+            '--preview=t=$(echo {} | awk \'{print $1}\'); if [ "$t" = "all" ]; then echo ""; echo "  ~/.claude/hooks/"; echo "  ~/.codex/hooks/"; else echo ""; printf "  ~/.%s/hooks/\\n" "$t"; fi',
+            '--preview-window=right:45%:wrap',
           ], {
             input: `claude   — ~/.claude/hooks/\ncodex    — ~/.codex/hooks/\nall      — claude + codex`,
             encoding: 'utf8',
@@ -1033,6 +1054,8 @@ try {
             '--header=  从哪里卸载  ·  tab 多选  ·  enter 确认  ·  esc 取消',
             '--layout=reverse', '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+            '--preview=t=$(echo {} | awk \'{print $1}\'); if [ "$t" = "all" ]; then echo ""; echo "  从所有平台卸载:"; echo ""; for p in claude cursor codex openclaw hermes opencode; do printf "  ~/.%s/skills/\\n" "$p"; done; else echo ""; printf "  ~/.%s/skills/\\n" "$t"; fi',
+            '--preview-window=right:45%:wrap',
           ], {
             input: targetChoices2.map(c => c.name).join('\n') + '\nall      — all targets',
             encoding: 'utf8', stdio: ['pipe', 'pipe', 'inherit'],
@@ -1046,6 +1069,8 @@ try {
             '--header=  卸载范围  ·  enter 确认  ·  esc 取消',
             '--layout=reverse', '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+            '--preview=s=$(echo {} | awk \'{print $1}\'); if [ "$s" = "user" ]; then echo ""; echo "  从 user 级卸载:"; echo "  ~/.{target}/skills/"; else echo ""; echo "  从 project 级卸载:"; echo "  .{target}/skills/"; fi',
+            '--preview-window=right:45%:wrap',
           ], {
             input: 'user     — 所有项目  (~/.{target}/skills/)\nproject  — 仅当前项目  (.{target}/skills/)',
             encoding: 'utf8', stdio: ['pipe', 'pipe', 'inherit'],
@@ -1065,6 +1090,8 @@ try {
             '--header=  Hook scope  ·  enter 确认',
             '--layout=reverse', '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+            '--preview=s=$(echo {} | awk \'{print $1}\'); if [ "$s" = "user" ]; then echo ""; echo "  从 user 级卸载 hook:"; echo "  ~/.claude/hooks/"; else echo ""; echo "  从 project 级卸载 hook:"; echo "  .claude/hooks/"; fi',
+            '--preview-window=right:45%:wrap',
           ], {
             input: `user     — ~/.claude/hooks/\nproject  — .claude/hooks/`,
             encoding: 'utf8', stdio: ['pipe', 'pipe', 'inherit'],

package/lib/installer.js

@@ -146,6 +146,21 @@ export async function installTools(tools, targetDir, force = false) {
         console.error(chalk.dim(`  · Installed ${toolName}.py`))
       }
 
+      // Copy extra paths (files or dirs) declared in tool.json `extraPaths`
+      // Each entry is a relative path from the tool source; copied to ~/.hskill/tools/{toolName}/
+      try {
+        const toolMeta = await fs.readJson(path.join(srcPath, 'tool.json'))
+        for (const rel of (toolMeta.extraPaths ?? [])) {
+          const src  = path.join(srcPath, rel)
+          const dest = path.join(dataDir, toolName, rel)
+          if (await fs.pathExists(src)) {
+            await fs.ensureDir(path.dirname(dest))
+            await fs.copy(src, dest, { overwrite: true })
+            console.error(chalk.dim(`  · Installed ${toolName}/${rel}`))
+          }
+        }
+      } catch { /* tool.json missing or no extraPaths — skip silently */ }
+
       installed.push(toolName)
       await _patchZshrc(srcPath, toolName)
     } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.13.0",
+  "version": "0.14.1",
   "description": "Skill manager for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {
@@ -41,6 +41,8 @@
     "skills/meta/npm-release/",
     "skills/meta/opencode-runner/",
     "tools/p-launch/",
+    "tools/todo-tool/",
+    "tools/hub/",
     "hooks/check-similar-branch/"
   ],
   "engines": {

package/skills/creative/add-todo/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-todo
-version: "4.0.0"
+version: "4.5.0"
 user_invocable: true
 description: "Add a new requirement, task, or feature request to any project's TODO.md — from any working directory. Triggers whenever the user wants to capture a new need — even phrased casually like 'we should do X later', 'add this to the backlog', 'note this down', 'remember to build X', 'we need to do Y at some point', or 'record this for later'."
 ---
@@ -88,6 +88,36 @@ description: "Add a new requirement, task, or feature request to any project's T
 todo project set-path [项目名] [本地路径]
 ```
 
+### 切换到 chore/todo 分支
+
+在写入前，在项目目录操作 git：
+
+```bash
+cd {local_path}
+
+# 1. 记录当前分支
+ORIGINAL_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+# 2. 确定 staging 基准分支（用于创建 chore/todo 及事后合并目标）
+if git show-ref --verify --quiet refs/heads/staging; then
+  BASE_BRANCH=staging
+else
+  BASE_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null \
+                | sed 's@^refs/remotes/origin/@@' || echo "main")
+fi
+
+# 3. 切换到 chore/todo（不存在则从 BASE_BRANCH 创建）
+if git show-ref --verify --quiet refs/heads/chore/todo; then
+  git checkout chore/todo
+else
+  git checkout -b chore/todo "$BASE_BRANCH"
+fi
+```
+
+**非 git 仓库**：若 `local_path` 不在 git 仓库中，跳过此步骤，直接写入文件。
+
+**BRANCH_GUARD hook**：执行 `git checkout -b chore/todo` 时，BRANCH_GUARD hook 可能会提示与其他分支语义相似。`chore/todo` 是永久追踪分支，不是功能分支，**直接确认新建，忽略相似分支警告**，继续执行后续步骤。
+
 ### 重复检查
 
 加载文件，扫描是否有语义重叠的已有条目。若有：
@@ -118,6 +148,25 @@ todo project set-path [项目名] [本地路径]
 ## ✅ 已完成
 ```
 
-写入后确认：
+### 提交、合并到 staging、切回原分支
+
+写入后在项目目录执行：
+
+```bash
+cd {local_path}
+
+# 1. 在 chore/todo 上提交
+git add TODO.md
+git commit -m "todo: add [任务标题]"
+
+# 2. 合并到 staging（或主分支）
+git checkout "$BASE_BRANCH"
+git merge --no-ff chore/todo -m "Merge chore/todo: add [任务标题]"
+
+# 3. 切回原分支
+git checkout "$ORIGINAL_BRANCH"
+```
+
+完成后确认：
 
-> "✅ 已将 **[任务标题]** 写入 `{local_path}/TODO.md`。"
+> "✅ 已将 **[任务标题]** 写入 `{local_path}/TODO.md`，提交到 `chore/todo`，合并到 `$BASE_BRANCH`，当前回到 `$ORIGINAL_BRANCH`。"

package/skills/meta/npm-release/SKILL.md

@@ -2,7 +2,7 @@
 name: npm-release
 description: "Complete npm publish workflow for harveyz-skill: bump version, update CHANGELOG, create release branch, merge to staging then main, tag, and publish to npm. Use this skill whenever the user wants to release, publish, cut a version, bump version, ship to npm, or deploy a new package version."
 user_invocable: true
-version: "1.1.0"
+version: "1.2.0"
 ---
 
 # npm-release
@@ -100,14 +100,26 @@ npm version <new-version> --no-git-tag-version
 
 ---
 
+## Step 3.5 — 同步 .npmignore 和 package.json files 字段
+
+运行生成脚本，确保 `.npmignore` 和 `package.json` 中的 `files` 字段与当前 `skills-index.json` 保持一致：
+
+```bash
+node scripts/generate-npmignore.js
+```
+
+检查输出有无报错。此步骤必须在提交前完成，否则新增或重命名的 skill 路径不会被正确包含/排除。
+
+---
+
 ## Step 4 — 创建 release 分支并提交
 
 ```bash
 # 从当前 staging 切出 release 分支
 git checkout -b release/<new-version>
 
-# 只提交 CHANGELOG 和 package.json、package-lock.json
-git add CHANGELOG.md package.json package-lock.json
+# 提交 CHANGELOG、package.json、package-lock.json 和 .npmignore
+git add CHANGELOG.md package.json package-lock.json .npmignore
 git commit -m "chore(release): bump version to <new-version>"
 ```
 

package/skills/research/youtube-learner/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: youtube-learner
-version: "1.3.0"
+version: "1.3.1"
 description: "Process a YouTube video using the vdl CLI: transcribe, generate article and summary. Triggers when the user provides a YouTube URL and wants to learn from, summarize, transcribe, or extract key points from the video — e.g. 'help me understand this talk', 'summarize this YouTube video', 'get the transcript', 'process this video', 'summarize it'."
 user_invocable: true
 ---
@@ -35,7 +35,7 @@ npm link
 | `url` | YouTube 链接 | 从用户消息提取 |
 | `--focus` | 关注点（影响摘要内容） | 若用户未提供，主动询问："你最想从这个视频中了解什么？（例如：核心论点、技术细节、行动项）" |
 | `--mode` | 处理模式 | **必须询问用户**（见下方「模式选择」） |
-| `--lang` | 输出语言 | 默认 `zh-CN`；若用户用英文交流则用 `en` |
+| `--lang` | 输出语言 | 默认 `zh-CN`；若用户用英文交流则用 `en`；必须将解析结果赋给 `<LANG>` 占位符 |
 
 ### 模式选择
 
@@ -64,9 +64,18 @@ npm link
 
 ## 执行命令
 
+将以下占位符全部替换后再执行：
+
+| 占位符 | 替换为 |
+|--------|--------|
+| `<URL>` | YouTube 链接 |
+| `<FOCUS>` | 用户填写的关注点 |
+| `<MODE>` | `transcript` / `audio` / `media` / `full` |
+| `<LANG>` | `zh-CN`（中文对话）或 `en`（英文对话） |
+
 ```bash
 cd /Users/harveyzhang96/Projects/Video-Learner && \
-vdl "<URL>" --focus "<FOCUS>" --mode <MODE> --lang zh-CN
+vdl "<URL>" --focus "<FOCUS>" --mode <MODE> --lang <LANG>
 ```
 
 `vdl` 会自动：

package/skills-index.json

@@ -1,11 +1,21 @@
 {
   "toolBundleMeta": {
-    "shell-tools": "终端工具（p-launch 本地仓库管理器）"
+    "shell-tools": "终端工具（p-launch 本地仓库管理器 + todo-tool 任务管理器）",
+    "tools": "开发者 OS 工具（hub — 项目管理 + git 状态 + 任务跟踪）"
   },
   "tools": [
     {
       "name": "p-launch",
       "bundle": "shell-tools"
+    },
+    {
+      "name": "todo-tool",
+      "bundle": "shell-tools"
+    },
+    {
+      "name": "hub",
+      "path": "tools/hub",
+      "bundle": "tools"
     }
   ],
   "bundleMeta": {

package/tools/hub/hub/__main__.py

@@ -0,0 +1,24 @@
+import sys
+
+
+def main():
+    from hub.core.db import HubDB
+    from hub.core.migrate import needs_migration, run_migration
+
+    db = HubDB()
+    if needs_migration():
+        n = run_migration(db)
+        if n:
+            import typer
+            typer.echo(f"hub: migrated {n} tasks from todo-tool ✓")
+
+    if len(sys.argv) == 1:
+        from hub.tui.app import HubApp
+        HubApp().run()
+        return
+    from hub.cli import app
+    app()
+
+
+if __name__ == "__main__":
+    main()

package/tools/hub/hub/cli/__init__.py

@@ -0,0 +1,14 @@
+import json
+import sys
+import typer
+
+from hub.cli import projects as proj_cmd
+from hub.cli import tasks as task_cmd
+
+app = typer.Typer(
+    name="hub",
+    no_args_is_help=False,
+    add_completion=False,
+)
+app.add_typer(proj_cmd.app, name="projects")
+app.add_typer(task_cmd.app, name="tasks")

package/tools/hub/hub/cli/projects.py

@@ -0,0 +1,100 @@
+import json
+import os
+import sys
+from pathlib import Path
+from typing import Optional
+
+import typer
+
+from hub.core.db import HubDB
+from hub.core import projects as proj
+
+app = typer.Typer(no_args_is_help=True)
+
+_DEFAULT_MD = Path.home() / ".hskill" / "public" / "PROJECTS.md"
+
+
+def _md_path() -> Path:
+    if env := os.environ.get("HUB_MD_PATH"):
+        return Path(env)
+    return _DEFAULT_MD
+
+
+def _out(data, json_out: bool) -> None:
+    if json_out:
+        print(json.dumps({"ok": True, "data": data}))
+
+
+def _err(msg: str, json_out: bool) -> None:
+    if json_out:
+        print(json.dumps({"ok": False, "error": msg}))
+    else:
+        typer.echo(f"Error: {msg}", err=True)
+    raise SystemExit(1)
+
+
+@app.command("list")
+def projects_list(json_out: bool = typer.Option(False, "--json")):
+    """List all registered projects."""
+    db = HubDB()
+    projects = proj.list_projects(db)
+    if json_out:
+        _out(projects, json_out)
+    else:
+        if not projects:
+            typer.echo("No projects. Use: hub projects add <name> --path <path>")
+            return
+        for p in projects:
+            typer.echo(f"  {p['name']:<24} {p['path'] or ''}")
+            if p.get("description"):
+                typer.echo(f"    {p['description']}")
+
+
+@app.command("add")
+def projects_add(
+    name: str = typer.Argument(..., help="Project name (GitHub repo name)"),
+    path: str = typer.Option("", "--path", help="Local directory path"),
+    description: str = typer.Option("", "--desc", help="Short description"),
+    json_out: bool = typer.Option(False, "--json"),
+):
+    """Register or update a project."""
+    db = HubDB()
+    result = proj.add_project(db, name, path=path, description=description, md_path=_md_path())
+    if json_out:
+        _out(result, json_out)
+    else:
+        typer.echo(f"✓ {name}")
+
+
+@app.command("path")
+def projects_path(
+    name: str = typer.Argument(...),
+    json_out: bool = typer.Option(False, "--json"),
+):
+    """Print the local path for a project (for shell cd / agent use)."""
+    db = HubDB()
+    p = proj.get_project_path(db, name)
+    if p is None:
+        _err(f"Project '{name}' not found", json_out)
+    if json_out:
+        _out(p, json_out)
+    else:
+        print(p)
+
+
+@app.command("sync")
+def projects_sync(json_out: bool = typer.Option(False, "--json")):
+    """Re-scan configured dirs and update PROJECTS.md. (Requires p-launch config.)"""
+    try:
+        import sys as _sys
+        _sys.path.insert(0, str(Path(__file__).parents[4] / "p-launch"))
+        from p_launch import read_project_dirs, collect_repos, sync_to_index
+        dirs = read_project_dirs()
+        repos = collect_repos(dirs)
+        sync_to_index(repos, _md_path())
+        if json_out:
+            _out({"scanned": len(repos)}, json_out)
+        else:
+            typer.echo(f"✓ Scanned {len(repos)} repos")
+    except ImportError:
+        _err("p-launch not installed; cannot auto-scan", json_out)

package/tools/hub/hub/cli/tasks.py

@@ -0,0 +1,114 @@
+import json
+import sys
+from typing import Optional
+
+import typer
+
+from hub.core.db import HubDB
+from hub.core import tasks as task
+
+app = typer.Typer(no_args_is_help=True)
+
+
+def _out(data, json_out: bool) -> None:
+    if json_out:
+        print(json.dumps({"ok": True, "data": data}))
+
+
+def _err(msg: str, json_out: bool) -> None:
+    if json_out:
+        print(json.dumps({"ok": False, "error": msg}))
+    else:
+        typer.echo(f"Error: {msg}", err=True)
+    raise SystemExit(1)
+
+
+@app.command("list")
+def tasks_list(
+    project:  Optional[str] = typer.Option(None, "--project",  "-p"),
+    status:   Optional[str] = typer.Option(None, "--status",   "-s"),
+    priority: Optional[str] = typer.Option(None, "--priority", "-P"),
+    json_out: bool           = typer.Option(False, "--json"),
+):
+    """List tasks, optionally filtered."""
+    db = HubDB()
+    tasks = task.list_tasks(db, project=project, status=status, priority=priority)
+    if json_out:
+        _out(tasks, json_out)
+    else:
+        if not tasks:
+            typer.echo("No tasks.")
+            return
+        for t in tasks:
+            check = "✓" if t["status"] == "done" else "○"
+            typer.echo(f"  [{t['id']:>4}] {check} [{t['priority']}] {t['title']}  ({t['project']})")
+
+
+@app.command("add")
+def tasks_add(
+    title:    str           = typer.Argument(...),
+    project:  str           = typer.Option(..., "--project", "-p"),
+    priority: str           = typer.Option("P2", "--priority", "-P"),
+    json_out: bool          = typer.Option(False, "--json"),
+):
+    """Add a new task."""
+    db = HubDB()
+    try:
+        t = task.add_task(db, title=title, project=project, priority=priority)
+    except ValueError as e:
+        _err(str(e), json_out)
+    if json_out:
+        _out(t, json_out)
+    else:
+        typer.echo(f"✓ [{t['id']}] {t['title']}")
+
+
+@app.command("done")
+def tasks_done(
+    task_id:  int  = typer.Argument(...),
+    json_out: bool = typer.Option(False, "--json"),
+):
+    """Mark a task as done."""
+    db = HubDB()
+    result = task.mark_done(db, task_id)
+    if result is None:
+        _err(f"Task {task_id} not found", json_out)
+    if json_out:
+        _out(result, json_out)
+    else:
+        typer.echo(f"✓ done: {result['title']}")
+
+
+@app.command("update")
+def tasks_update(
+    task_id:  int            = typer.Argument(...),
+    title:    Optional[str]  = typer.Option(None, "--title"),
+    priority: Optional[str]  = typer.Option(None, "--priority"),
+    status:   Optional[str]  = typer.Option(None, "--status"),
+    json_out: bool           = typer.Option(False, "--json"),
+):
+    """Update task fields."""
+    db = HubDB()
+    result = task.update_task(db, task_id, title=title, priority=priority, status=status)
+    if result is None:
+        _err(f"Task {task_id} not found", json_out)
+    if json_out:
+        _out(result, json_out)
+    else:
+        typer.echo(f"✓ updated [{task_id}]")
+
+
+@app.command("rm")
+def tasks_rm(
+    task_id:  int  = typer.Argument(...),
+    json_out: bool = typer.Option(False, "--json"),
+):
+    """Delete a task."""
+    db = HubDB()
+    deleted = task.delete_task(db, task_id)
+    if not deleted:
+        _err(f"Task {task_id} not found", json_out)
+    if json_out:
+        _out({"deleted": True}, json_out)
+    else:
+        typer.echo(f"✓ deleted [{task_id}]")