# Rem

> 管理 macOS Reminders。處理「提醒我 XXX」「記一下 XXX」等中文自然語言指令，支援 briefing 待辦整合。當用戶提及提醒事項、待辦、Reminders、或要建立/查詢/完成/刪除提醒時使用。

- **Type:** Skill
- **Install:** `agentstack add skill-fredchu-claude-dotfiles-rem-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [fredchu](https://agentstack.voostack.com/s/fredchu)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [fredchu](https://github.com/fredchu)
- **Source:** https://github.com/fredchu/claude-dotfiles/tree/main/skills/rem-cli

## Install

```sh
agentstack add skill-fredchu-claude-dotfiles-rem-cli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# rem — macOS Reminders CLI

## 環境

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

## 非互動規則

| 情境 | 規則 |
|------|------|
| delete | 必須加 `--force`（非互動環境無法確認） |
| list-mgmt delete | 必須加 `--force` |
| add / update | 禁用 `-i`（interactive mode） |
| 搬移 list | update 不支援改 list → 必須 delete --force + add 重建 |
| 確認動作 | 刪除前先 show 該項目，告知用戶內容，再執行 |

## List 智能路由

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

| 關鍵詞特徵 | 目標 List |
|-----------|----------|
| 投資/股票/選擇權/ETF/財報/持倉/殖利率/配息 | Investing |
| 程式/code/bug/deploy/PR/skill/app/API | dev |
| 煮/食譜/買菜/超市/料理 | Cooking |
| 掃地/洗衣/倒垃圾/拖地/吸塵/換床單 | 例行家事 |
| 拍照/底片/暗房/沖片/相機 | 攝影暗房 |
| 遊戲/PS5/Switch/Steam/Xbox | Video Games |
| 家人名字/家庭事務/爸媽/小孩 | Family |
| 書/讀/閱讀 | 書 |
| 以上都不符合 | 雜 |

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

## 指令速查

```
/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  -o json
/Users/fredchu/bin/rem update  --name "new" --due "next mon" --priority medium --notes "N"
/Users/fredchu/bin/rem delete  --force
/Users/fredchu/bin/rem complete 
/Users/fredchu/bin/rem uncomplete 
/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 
/Users/fredchu/bin/rem unflag 
```

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 值

| 用戶說 | --due 值 |
|--------|---------|
| 明天 | tomorrow |
| 後天 | "in 2 days" |
| 大後天 | "in 3 days" |
| 下週一 | "next monday" |
| 下週五下午三點 | "next friday at 3pm" |
| 月底 | 當月最後一天 ISO 格式 |
| X 小時後 | "in X hours" |
| 今天下午五點 | "today at 5pm" |
| 下個月 | "next month" |
| 今天下班前 | eod |
| 這週五前 | "next friday" 或本週五 ISO |

完整日期語法見 [references/dates.md](references/dates.md)。

## JSON 輸出結構

`rem list -o json` 回傳陣列，每個項目：
```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](references/commands.md)。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [fredchu](https://github.com/fredchu)
- **Source:** [fredchu/claude-dotfiles](https://github.com/fredchu/claude-dotfiles)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-fredchu-claude-dotfiles-rem-cli
- Seller: https://agentstack.voostack.com/s/fredchu
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.