What is ai-schedule?

AI Schedule is a macOS tool that runs pre written Claude Code tasks automatically, but only when certain conditions about the user's subscription quota are met, such as having at least half of the current five hour usage window left with the reset coming up soon, or it being a particular day and time within the weekly quota. The idea is to use quota that would otherwise expire unused rather than let it go to waste. The tool runs entirely on the user's own Mac using the Python 3 that already comes installed, with no extra packages to download and no external servers involved. It reads the same quota information that the official Claude Code client uses, authenticating with the user's own login stored in the macOS Keychain, so nothing about usage or account details leaves the machine. A background daemon checks quota on a schedule the user sets, and each task is guaranteed to run at most once per five hour window or once per week, even if a previous run failed, so tasks cannot accidentally burn through quota by retrying forever. Once installed, a command line tool called ais lets a user check current quota and reset times, add a new scheduled task through an interactive menu, turn automatic running on or off, and open a local web dashboard that shows live quota gauges, a history of past runs with their cost and duration, and a form for scheduling new tasks. For work too large to fit in a single run, a planning mode can break a big request into smaller self contained chunks, each with its own model and effort setting, and then run them one at a time whenever quota allows, pausing and resuming automatically across quota windows and even across days until the whole job is done and a final report is written. The project is released under the MIT license and is written in Python. It supports both English and Korean interfaces, matching the language of the user's browser or terminal.