A collection of automation tools and utility scripts for Cookie Clicker (macOS / Steam).
Automates the 1,000 ascensions required for the Endless Cycle shadow achievement in Cookie Clicker.
The script runs a continuous ~1-minute loop that buys starter upgrades and Cursors, scrolls to purchase high-tier producers (Prism, Fractal Engine, You), buys all upgrades to reach the +1 Prestige threshold, triggers Legacy, and clicks Reincarnate to repeat.
- 10-Step Automated Pipeline: Handles building purchases, scrolling, upgrades, legacy ascension, and reincarnation in one continuous loop.
- Vision-Based Matching: Uses OpenCV and PyAutoGUI to locate buttons reliably across Retina and standard displays.
- Process Guardrails: Executes clicks only when Cookie Clicker is active and focused (via macOS
osascript). - Hotkey & Failsafe Controls:
- q — Pause / resume.
- Esc — Exit immediately.
- Moving the mouse to any corner triggers the PyAutoGUI failsafe stop.
Cookie.Clicker.Endless.Cycle.Script.Demo.mov
Note
Ascension speed and purchase timing depend on your Prestige level and chosen permanent upgrades.
- Tested Prestige: ~52 trillion
- Permanent Upgrades: Kitten strategists, Fortune #103, Kitten Admins, United Workforce, Omelette
- macOS Permissions: Ensure your terminal has Accessibility and Screen Recording permissions enabled in System Settings > Privacy & Security.
Run directly with uv (dependencies are declared via PEP 723 inline script metadata):
uv run scripts/endless-cycle.py- Focus the Cookie Clicker window.
- Press q to start or pause the loop (Esc to quit).
cookie-clicker/
├── assets/ # UI image templates for OpenCV/PyAutoGUI matching
├── scripts/ # Automation scripts
│ └── endless-cycle.py # Endless Cycle shadow achievement bot
├── pyproject.toml
└── README.md
More helper scripts and automation tools for other achievements, minigames (Stock Market, Garden), or combo setups may be added here over time.