ZOYKUHot Board

ryanzhangntu/codex-pacerDocumentazione

A Dynamic Island for your Mac or Windows PC that keeps an eye on Codex, Claude Code and DeepSeek Harness: running tasks, output speed and quota pace, right at the notch.

Nota sulla lingua:Documentazione tradotta non disponibile. Visualizzazione dell'originale ufficiale in inglese.
Installazione rapida
git clone https://github.com/ryanzhangntu/codex-pacer.git

Codex Pacer app icon

Codex Pacer

A Dynamic Island for your Mac or Windows PC that keeps an eye on Codex, Claude Code and DeepSeek Harness:
running tasks, output speed, quota pace and balance, right at the notch.

Latest release macOS 14 or later Universal app for Apple Silicon and Intel Windows 10 2004 or later, x64 and ARM64 MIT License

Download  ·  User Guide  ·  简体中文

Codex Pacer at the notch, with sample data: hovering opens a Claude Code task, a Codex task over SSH and a DeepSeek Harness task, each with its speed, model and reasoning effort; an approval request turns the island amber, and clicking the task opens its Claude window; then Codex alone with pace and a forecast, Codex with a Claude cloud thread, DeepSeek alone with daily and weekly budgets, and the same island on Windows

At a glance

Collapsed, Pacer is a slim bar around the camera that tells you how your agents are doing without opening anything.

The collapsed bar: a task badge and output speed on the left of the camera, quota rings and the DeepSeek balance on the right

What it tells you
Task badge How many tasks are running. An orbit turns while they work, teal for Codex, orange for Claude and blue for DeepSeek. Solid amber means a task is waiting for your reply or approval; a check marks a task that just ended. When the only running task reports its progress, the badge shows it as an arc.
Speed Combined output of the running tasks, in tokens per second.
Quota Remaining quota for Codex and Claude, and the DeepSeek balance or budget. Two rings show the modules you choose; the number alternates between the services.
Warnings Appear only when needed: the 5-hour quota is low, an SSH host is disconnected, quota has not updated, or DeepSeek's balance is low, spending spikes or a budget runs out.

Hover to expand, move away to collapse, and click the top to keep it open.

Everything in one panel

  • Every task in one list. Codex and Claude Code tasks on this Mac or PC, on your SSH hosts, in WSL on Windows and through Codex Remote Control, threads and coordinators in Claude's cloud Projects, and local DeepSeek Harness tasks, each with its current stage, model and reasoning effort, turn time and output speed. Agents a task spawns are grouped under it.
  • Progress on every task. Codex, Claude Code and DeepSeek Harness report how much of your request is done, drawn as a ring around the task's icon. A comet circles until the first estimate, light runs along the arc while the task works, and a task that needs you or has ended fills a solid disc.
  • Jump back in. Click a task to open its conversation. An ended task stays as a card until you open it or its retention time passes, so nothing finishes unnoticed.
  • Quota with pace. Each service has one ring: a shorter upper arc for 5 hours and a longer lower arc for 7 days, each with its own remaining quota, reset countdown and white pace tick. Accounts without a 5-hour limit get a weekly gauge that opens at the bottom. With one service on, its pace, reset time and a forecast sit beside the ring. Switch to the original Classic layout in Settings → Appearance → Expanded Quota.
  • DeepSeek by balance or budget. DeepSeek charges a balance instead of quota windows, so its dial is today on a 24-hour face: what each hour cost, the doubled-price peak hours and the balance in the middle. Switch to daily and weekly budgets and the dial paces them like quota. Pacer checks balance changes against its own estimate, so spend not made on this Mac, such as web searches or another device, counts too, and it warns you when 10 minutes cost more than usual. Each task shows its turn's estimated cost, and with DeepSeek alone the panel adds where today's money went and the last 7 days. The balance comes from a DeepSeek platform sign-in in Pacer's own window or an API key, whichever matches how Harness signs in.
  • An overview and history. Pacer's main window opens on an Overview of every service and anything that needs you. History keeps each service's quota curve for the current cycle, credits and banked resets when the service reports them, and DeepSeek's last seven days.

DeepSeek alone, with sample data: the day dial with the balance and a ×2 until 6:00 PM chip, beside today's spend, the last two hours' speed and where today's money went, including a hatched Not on this Mac part, above the last 7 days

Make it yours

Collapsed Bar in the main window: the bar on a live preview, the component library below and the selected Activity badge's settings

  • Arrange the bar. On a live preview, drag components between the left and right of the camera, hide what you don't need, choose which module each quota ring shows, and pick 5 hours or 7 days for each service's quota. With DeepSeek alone, a price clock shows the peak hours at a glance.
  • Black or Liquid Glass. On macOS 26 and later the island can use Liquid Glass, and its clarity follows the system setting.
  • Theme and accent color. Pacer's windows follow the system or stay light or dark, and an accent color tints rings, progress and selection.
  • Place the island where it fits. Keep it at the top center around the notch, or choose Free Move and drag the status bar anywhere; released near a screen edge, it snaps there. Choose a display and whether the island appears over full-screen apps.
  • Only what you use. Turn the Codex, Claude and DeepSeek modules on or off independently.
  • Notifications, if you want them. macOS notifications when a task needs you or ends, quota or the balance runs low, DeepSeek spending spikes or a budget runs out.
  • In your language. English and Simplified Chinese.

Get started

The welcome guide's first page: the collapsed bar around the camera, with callouts for tasks, speed, quota left and warnings

  1. Download the latest release and install it as described below.
  2. Open Codex Pacer. A short guide explains the island, lets you choose Island or Free Move and the services to follow, and covers progress rings, notifications and opening at login. Open it again from Settings → Help & Updates.
  3. To see Claude quota, sign in once in Pacer's own Claude window. Task tracking for Claude Code and SSH hosts sets itself up. For the DeepSeek balance, sign in to the DeepSeek platform in Pacer's window, or paste an API key if Harness uses one.

Install

Mac

Codex Pacer is distributed as a universal DMG signed with Developer ID and notarized by Apple.

  1. Double-click the downloaded DMG and drag Codex Pacer into Applications.
  2. Open Codex Pacer from Applications. macOS asks once to confirm an app downloaded from the internet; click Open.

After that, Pacer updates itself: it checks daily, shows a new version in its window and installs it with one click on Update and Restart, then shows what changed once. Settings → Help & Updates → Check for Updates checks right away. See Apple's guide to opening apps for more on Gatekeeper.

Windows

  1. Download Codex-Pacer-VERSION-windows-x64-setup.exe from the latest release, or windows-arm64-setup.exe on an ARM PC, and run it. It installs for the current user without administrator rights.
  2. The installer is not code signed yet. If SmartScreen says "Windows protected your PC", choose More info → Run anyway.

Updates then work as on the Mac, from Settings → Help & Updates. Uninstall from Windows Installed apps; preferences and read history are kept. For screenshots with sample data, quit Pacer and run CodexPacer.exe --demo from its install folder (%LOCALAPPDATA%\Programs\Codex Pacer by default). More details are in Windows installation.

Requirements

  • macOS 14 Sonoma or later, on Apple silicon or Intel. Liquid Glass needs macOS 26.
  • Or Windows 10 2004 (build 19041) or later, x64 or ARM64. The glass surface needs Windows 11 22H2, and Claude and DeepSeek sign-in need the WebView2 Runtime, which Windows 11 includes.
  • Codex (app or CLI), Claude Code or DeepSeek Harness, any combination, installed and signed in.
  • Python 3 for the setup and SSH helpers; SSH hosts need Python 3.6 or later and non-interactive OpenSSH access.
  • For Codex Remote Control tasks, keep the Codex app open and connected to the remote host.

Privacy

  • Local first. Pacer has no account and no analytics. It reads the session logs that Codex, Claude Code and DeepSeek Harness already write and keeps only what the island shows: task titles, stages, models, timing and token counts, never the content of your prompts or responses.
  • Your own sign-ins. Codex quota comes from your Codex CLI. Claude quota comes from Claude Code's status line or a claude.ai session in Pacer's own window, which also follows your cloud Projects. The DeepSeek balance comes from a platform session in Pacer's own window or a key you paste, kept in your keychain. Pacer never reads other apps' Keychain items, credentials or browser cookies.
  • Reversible setup. For Claude Code, Pacer adds its own hooks and a local-only telemetry endpoint next to your existing settings, and removes them when you turn the Claude module off. Progress rings add a small local reporting tool to Claude Code, Codex and Harness that sends Pacer only a number; turning a ring off removes it.
  • Few network requests. Pacer connects only to your SSH hosts, the services' own quota endpoints and GitHub for updates.
  • Screen sharing. Hide Project Names in Settings replaces task titles on screen.

Build from source

Requires Xcode 26 or later. Swift Package Manager fetches the only dependency, Sparkle.

make build                                  # builds the app and prints its path
make test TEST_FILTER='CompletionInboxTests' # runs selected test suites

Read Contributing to get started, development notes for architecture and data semantics, and releasing for packaging. Report security issues privately as described in SECURITY.md.

License

MIT. Codex Pacer is an independent project and is not affiliated with OpenAI, Anthropic or DeepSeek. Codex, Claude and DeepSeek are trademarks of their respective owners. Codex Pacer includes the decompression part of Zstandard (BSD license).

Mirror archiviato dal repository ufficiale GitHub · Visita su GitHub
Data snapshot: 2026-11-09