timer

タイマー

バックグラウンドで実行されるタイマーを設定します。タイマーが完了すると、システム通知が届くので、ユーザーに知らせるため、必ずリマインダーに応答してください。

クイックスタート

# Set a 5-minute timer
bash background:true command:"node {baseDir}/timer.js 5m"

# Set a timer with a label
bash background:true command:"node {baseDir}/timer.js 10m 'Check the oven'"

# Set a timer in seconds
bash background:true command:"node {baseDir}/timer.js 30s"

# Set a timer in hours
bash background:true command:"node {baseDir}/timer.js 1h"

時間の形式

形式	説明	例
Ns	N 秒	30s、90s
Nm	N 分	5m、15m
Nh	N 時間	1h、2h
N	N 分（デフォルト）	5 = 5 分
MM:SS	分と秒	5:30
HH:MM:SS	時間、分、秒	1:30:00

⚠️ 重大：タイマー完了通知

タイマーが完了すると、次のような System: メッセージが届きます：

System: [2026-01-24 21:27:13] Exec completed (swift-me, code 0) :: ⏰ Timer complete! Check the pasta!

❌ 誤り — 次のように応答しないでください：

HEARTBEAT_OK

🎉 Your timer is complete! Check the pasta!

この応答はフィルタリングされ、ユーザーには届きません！

✅ 正しい — 次のように応答してください：

⏰ Timer Alert! Your timer is complete: Check the pasta!

通知メッセージから直接始めてください。HEARTBEAT_OK は含めないでください。

理由： HEARTBEAT_OK で始まり、300 文字未満の応答は自動的に抑制され、ユーザーに届きません。タイマー通知が失われてしまいます！

例

料理タイマー

bash background:true command:"node {baseDir}/timer.js 12m 'Pasta is ready!'"

完了時の応答：「⏰ 12 分のタイマーが終了しました！パスタができました！」

クイックリマインダー

bash background:true command:"node {baseDir}/timer.js 2m 'Take a break'"

ポモドーロセッション

# Work session
bash background:true command:"node {baseDir}/timer.js 25m 'Pomodoro done - time for a break!'"
# After user is notified...
# Break
bash background:true command:"node {baseDir}/timer.js 5m 'Break over - back to work!'"

複数のタイマー

bash background:true command:"node {baseDir}/timer.js 5m 'Tea is ready'"
bash background:true command:"node {baseDir}/timer.js 10m 'Eggs are done'"
bash background:true command:"node {baseDir}/timer.js 30m 'Meeting starts soon'"

タイマーの管理

# List all running timers
process action:list

# Check specific timer status
process action:poll sessionId:XXX

# View timer output
process action:log sessionId:XXX

# Cancel a timer
process action:kill sessionId:XXX

注意事項

• タイマーは一意の sessionIds を持つバックグラウンドプロセスとして実行されます
• 完了したタイマーはコード 0 で終了します
• キャンセルされたタイマー（kill による）はコード 130 で終了します
• タイマー完了時、macOS ではサウンド通知が再生されます（afplay が利用可能な場合）
• 進行状況は 1 秒ごと（短いタイマー）または 10 秒ごと（長いタイマー）に記録されます