Scheduling Claude Code on macOS: An Introduction to Remind

Claude Code, Anthropic's command-line interface for agentic AI, is a powerful tool for developers, but it lacks a native scheduling mechanism for local execution. For those who want to automate repetitive tasks or schedule specific prompts to run at a later time, the gap between a CLI tool and a system-level scheduler is a significant hurdle.

Remind is a lightweight utility designed to bridge this gap by leveraging the native macOS Reminders app as a trigger mechanism. By turning a simple task list into a command center for AI automation, Remind allows users to schedule Claude Code prompts directly from their Apple ecosystem, including iPhones and Apple Watches.

How Remind Works

At its core, Remind monitors a specific list within the macOS Reminders app called "Remind." When a user adds a reminder with a due date and time, the tool monitors for these events. At the scheduled time, Remind triggers the terminal and executes the claude command using the prompt provided in the reminder's notes section.

Key technical features include:

• Cross-Device Scheduling: Because it utilizes the native Reminders app, any reminder added via iCloud—whether from an Apple Watch or an iPhone—will sync to the Mac and trigger the tool.
• Session Persistence: Remind supports frontmatter in the reminder notes, allowing it to continue an existing Claude session. It employs a "Stop hook" to capture the session ID, ensuring that subsequent scheduled runs can pick up exactly where the previous execution left off.
• System Requirements: The tool is built for macOS 15+ and requires claude to be installed and available in the user's $PATH.

Workflow Integration and Automation

The integration of a CLI agent into a system-level reminder app transforms the prompt into a scheduled task. This allows for a variety of use cases, such as scheduled code reviews, automated system checks, or periodic reports generated by Claude Code.

One of the most significant advantages of this approach is the feedback loop. Once Claude Code completes its task, Remind writes the results of the execution back into the reminder itself. This converts the reminder from a simple trigger into a record of the AI's output, providing a persistent log of the terminal output directly within the Reminders app.

Community Perspectives and Considerations

While the tool provides a streamlined way to automate Claude Code, users in the community have raised important questions regarding portability and compliance.

Portability to Linux

Developers have expressed interest in whether the mechanism used by Remind Remind is strictly macOS-specific. Given that it relies heavily on the native Reminders app and iCloud synchronization, the tool is currently deeply integrated into the Apple ecosystem. Porting it to Linux would require replacing the macOS Reminders API with a different scheduling or task management system.

Terms of Service and Automation

Another point of discussion is the notion of automation. Some users have questioned whether local automation of Claude Code via tools like Remind aligns with Anthropic's Terms of Service. There is a recurring concern that AI providers prefer automation to be handled via cloud-based APIs where they can implement more precise billing and monitoring.

Notification Workflows

While Remind writes results back to the reminder, some users have suggested that a prompt could be used to invoke other CLI tools or skills (such as sending an email) to alert the user if a specific condition is met. This suggests a potential evolution of the tool from a simple "run and record" utility to a more complex agentic workflow where Claude Code acts as a trigger for other system actions.