Rem

rem — macOS Reminders CLI

環境

• 路徑：/Users/fredchu/bin/rem（不在 PATH，所有指令必須用完整路徑）
• 解析輸出時用 -o json，顯示給用戶時用預設 table
• 環境變數：NO_COLOR=1（避免 ANSI 碼干擾 JSON 解析）

非互動規則

List 智能路由

用戶沒指定 list 時，根據內容關鍵詞自動判斷目標 list：

現有 lists（供比對）：Family, Investing, 雜, 例行家事, dev, 攝影暗房, Work, 書, Gadgets, Cooking, Video Games

dev List 前綴 Convention

dev list 使用前綴分組，模擬 Reminders app 的段落結構（EventKit API 不支援 sections/subtasks）。

新增 dev items 時必須加前綴：

格式：{前綴} {項目名稱}（前綴和名稱之間用空格分隔）

搜尋特定群組：rem search "MK " --list "dev" --incomplete

分組顯示：讀取 dev list 後，用前綴分組呈現給用戶，而不是扁平列表。

排序 dev list：用戶說「排序」「整理 dev list」「排一下」時，用 JXA 腳本按前綴分組排序。

排序方法（JXA move({to: list}) 會移到 list 末尾）：

1. rem list --list "dev" --incomplete -o json 取得所有項目
2. 按前綴排序：MK → MKA → MKP → VF → EA → CC → DC → 無前綴（同前綴內按名稱字母序）
3. 按排好的順序依次 move({to: devList}) → 先 move 的排前面

// /tmp/sort_dev.js — 排序 dev list 的 JXA 腳本模板
const app = Application("Reminders");
const devList = app.lists.whose({name: "dev"})[0];
const sortedNames = ["MK item1", "MK item2", "MKA item1", ...]; // Python 產生
for (let i = 0; i < sortedNames.length; i++) {
    try {
        const rems = devList.reminders.whose({name: sortedNames[i], completed: false});
        if (rems.length > 0) rems[0].move({to: devList});
    } catch(e) {}
}

Python 排序邏輯：

prefix_order = {"MK": 0, "MKA": 1, "MKP": 2, "VF": 3, "EA": 4, "CC": 5, "DC": 6}
def sort_key(item):
    name = item["name"]
    for prefix in sorted(prefix_order.keys(), key=len, reverse=True):  # longest first
        if name.startswith(prefix + " "):
            return (prefix_order[prefix], name)
    return (99, name)

注意：longest prefix first 避免 MK 吃掉 MKA/MKP。

指令速查

/Users/fredchu/bin/rem add "title" --list "X" --due "tomorrow" --priority high --notes "N"
/Users/fredchu/bin/rem list --list "X" --incomplete -o json
/Users/fredchu/bin/rem show <id> -o json
/Users/fredchu/bin/rem update <id> --name "new" --due "next mon" --priority medium --notes "N"
/Users/fredchu/bin/rem delete <id> --force
/Users/fredchu/bin/rem complete <id>
/Users/fredchu/bin/rem uncomplete <id>
/Users/fredchu/bin/rem search "query" --list "X" --incomplete -o json
/Users/fredchu/bin/rem overdue -o json
/Users/fredchu/bin/rem upcoming --days N -o json
/Users/fredchu/bin/rem stats -o json
/Users/fredchu/bin/rem lists --count -o json
/Users/fredchu/bin/rem list-mgmt create "name"
/Users/fredchu/bin/rem list-mgmt delete "name" --force
/Users/fredchu/bin/rem list-mgmt rename "old" "new"
/Users/fredchu/bin/rem flag <id>
/Users/fredchu/bin/rem unflag <id>

Short ID：UUID 前 8 碼，任何唯一前綴皆可匹配。

中文自然語言處理

「提醒我 XXX」→ rem add

從語句解析 title + due date，路由到正確 list。

「記一下 XXX」→ 判斷 todo vs info

• 有動作/deadline → rem add（待辦）
• 純資訊/筆記 → 存 Apple Notes「Claude 工作區」

「briefing」→ 待辦部分

/Users/fredchu/bin/rem overdue -o json
/Users/fredchu/bin/rem upcoming --days 1 -o json

中文時間詞 → --due 值

完整日期語法見 references/dates.md。

JSON 輸出結構

rem list -o json 回傳陣列，每個項目：

{
  "id": "AB12CD34",
  "name": "title",
  "list_name": "dev",
  "due_date": "2026-03-06T09:00:00+08:00",
  "notes": "",
  "priority": 0,
  "priority_label": "none",
  "flagged": false,
  "completed": false
}

限制

• 無 tags、subtasks、recurrence（EventKit 不支援）
• --flagged 篩選較慢（~3-4s，走 JXA fallback）
• update 不能跨 list 搬移，需 delete + add

完整 flag 參考見 references/commands.md。