Codex Scheduler

Codex Scheduler provides small schedulers for automatically sending a Codex CLI message at a configured time.

This repository contains two platform-specific versions:

• macos/: native macOS helper with a SwiftUI app, pmset wake scheduling, and a LaunchAgent.
• ubuntu/: Ubuntu/systemd user timer version for always-on Linux machines.

macOS

The macOS version includes a native app and one-click activation script:

cd macos
./open_codex_scheduler_app.sh

Command-line activation:

cd macos
./activate_codex_scheduler.sh

Important macOS note: closed-lid execution depends on macOS power management. A scheduled pmset wake can become a short DarkWake, so exact closed-lid minute-level triggering is not guaranteed.

Ubuntu

The Ubuntu version uses a systemd --user timer. It is intended for Ubuntu 22.04+ and 24.04+ machines that are normally awake.

cd ubuntu
./activate_ubuntu.sh

Check status:

cd ubuntu
./status_ubuntu.sh

If the timer must run after the user logs out, enable lingering once:

sudo loginctl enable-linger "$USER"

Requirements

• Codex CLI installed and logged in.
• Python 3.10+.
• macOS version: macOS 13+ recommended.
• Ubuntu version: Ubuntu 22.04+ / 24.04+ with systemd --user.

Status

Preview release. The Ubuntu version is expected to be more reliable on always-on machines. The macOS version works best when the machine is awake or in a power state where macOS gives user services enough execution time.