Reminder CLI

一个基于 Rust 的命令行提醒工具，支持 cron 表达式和自然语言设置周期性提醒，并通过系统通知提醒用户。

安装

Homebrew (macOS/Linux)

brew tap Maidang1/tap
brew install reminder-cli

Cargo

cargo install reminder-cli

从源码构建

git clone https://github.com/Maidang1/reminder-cli
cd reminder-cli
cargo build --release

使用方法

安装后提供两个命令：reminder 和短命令 rem，功能完全相同。

添加提醒

# 一次性提醒 - 绝对时间
rem add -t "开会" -d "项目周会" -T "2025-12-25 10:00"

# 一次性提醒 - 相对时间
rem add -t "休息" -T "30m"          # 30分钟后
rem add -t "午餐" -T "2h"           # 2小时后
rem add -t "明天" -T "1d"           # 1天后

# 一次性提醒 - 自然语言
rem add -t "开会" -T "tomorrow 9am"
rem add -t "汇报" -T "next monday 14:00"
rem add -t "下班" -T "today 18:00"

# 周期性提醒 - 标准 cron 格式
rem add -t "每日站会" -c "0 0 9 * * *"

# 周期性提醒 - 英文描述（自动转换为 cron）
rem add -t "喝水" -c "every hour"
rem add -t "站会" -c "every day at 9am"
rem add -t "周会" -c "every monday at 10am"
rem add -t "工作提醒" -c "every weekday at 8:30"
rem add -t "休息" -c "every 30 minutes"

# 带标签的提醒
rem add -t "开会" -T "tomorrow 9am" --tags work,important

列出提醒

rem list                  # 列出所有活跃提醒
rem list --all            # 包括已完成的
rem list --tag work       # 按标签筛选

查看提醒详情

rem show 1946    # 使用短 ID 即可

暂停/恢复提醒

rem pause 1946   # 暂停提醒
rem resume 1946  # 恢复提醒

编辑提醒

rem edit -i 1946 -t "新标题"
rem edit -i 1946 -D "新描述"
rem edit -i 1946 -T "2025-12-31 23:59"
rem edit -i 1946 -c "every day at 10am"
rem edit -i 1946 --add-tags urgent
rem edit -i 1946 --remove-tags work

删除提醒

rem delete -i 1946

标签管理

rem tags    # 列出所有标签及数量

清理已完成的提醒

rem clean

后台守护进程

rem daemon start     # 启动守护进程
rem daemon status    # 查看状态（包括健康检查）
rem daemon stop      # 停止守护进程
rem daemon install   # 安装开机自启（macOS/Linux）

导入/导出

rem export -o backup.json    # 导出
rem import -i backup.json    # 导入
rem import -i backup.json -f # 导入并覆盖重复

日志管理

rem logs show           # 显示最近 50 条日志
rem logs show -l 100    # 显示最近 100 条日志
rem logs info           # 显示日志文件路径和大小
rem logs clear          # 清除所有日志

日志文件自动轮转，最大 1MB。超过后旧日志会被归档为 .old 文件。

时间格式

一次性提醒 (-T)

周期性提醒 (-c)

数据存储

• macOS: ~/Library/Application Support/reminder-cli/
• Linux: ~/.local/share/reminder-cli/
• Windows: %LOCALAPPDATA%\reminder-cli\

License

MIT