Automate Claude Pro/Max Usage Window Priming on macOS with agent-maxprime

Workflow value: 80/100
Status: active · Freshness: 70/100 · Confidence: 0.90 · Level: intermediate
Categories: Quality Control, Context & Memory, Debugging, Multi-Agent
Original source: r/ClaudeCode post/comment

What problem this solves

Claude Pro/Max users on macOS often 'waste' their 5-hour usage windows by forgetting to initiate a session, effectively shrinking their daily quota. This workflow automates the priming of these windows.

Summary

A macOS-specific tool (agent-maxprime) built with shell, Tcl expect, and launchd that automatically opens a Claude session, sends a 'Hey!' message, waits for a response, and then exits at scheduled intervals (e.g., three times a day) to ensure the 5-hour usage window is always activated from its earliest possible moment.

Why it is useful

This workflow provides a concrete, open-source solution to a common pain point for Claude Pro/Max users on macOS: ensuring the full 5-hour usage window is always claimed. It's specific, repeatable, and transferable within its target environment, offering a practical way to optimize resource usage without manual intervention. The use of built-in macOS tools (expect, launchd) makes it lightweight and dependency-free.

Workflow

1. Clone the agent-maxprime GitHub repository: git clone https://github.com/bunyodrafikov/agent-maxprime
2. Navigate into the cloned directory: cd agent-maxprime
3. Run the installation script: ./scripts/install.sh
4. Perform a one-time manual setup: run Claude once inside the repo directory and accept the 'trust this folder?' prompt.
5. The tool will now automatically prime Claude sessions at the default scheduled times (06:30, 11:30, 16:30) or custom times if configured.

Tools / artifacts

• macOS operating system
• Claude Pro/Max subscription
• Git
• Tcl expect (built into macOS)
• launchd (built into macOS)
• Shell scripts (from agent-maxprime GitHub repo)

Validation signals

• Author's claim of building and using the tool to solve a personal problem.
• Explicit mention of logging (~/Library/Caches/agent-maxprime/) for verifying runs.
• The solution directly addresses a known behavior of Claude's usage window mechanics.
• GitHub repository provides source code for review and verification.

Limitations

• Platform-specific (macOS only).
• Relies on expect which can sometimes be brittle with UI changes, though for a simple 'Hey!' it's likely robust.
• Low Reddit score might indicate limited initial community interest, not necessarily a flaw in the workflow itself.

Rate this workflow

Upvote this post if the workflow is useful, reproducible, or worth recommending.

Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.

Reply if it worked for you, failed, is outdated, or has a better alternative.

---

This post was generated automatically from the workflow library database.