Expectation: This is a development path, not a commercial download promise. Builds are local and ad-hoc signed. Do not weaken macOS security controls to make a build run.

What you need

macOS 14 or later.
Swift / Swift Package Manager available through Apple’s normal developer tooling.
Network access to resolve the pinned Swift package dependencies.
Your own ChatGPT sign-in; the rewrite backend uses the Codex App Server.
A supported ChatGPT, ChatGPT Work, or Codex composer surface.

Build from the repository

From a checkout of the Mac Prompt Rewriter repository, review the source and notices first, then run the release-scoped source build:

./build-source.sh
open "dist/Mac Prompt Rewriter.app"

The helper defaults to commercial mode, compiles release configuration, and fails closed until the required public license configuration is present. It builds a local dist/Mac Prompt Rewriter.app bundle with an ad-hoc signature. It is not notarized or a supported signed release artifact. Until clean-machine validation and the commercial release gates are complete, this guide is informational and the source edition is not buyer-ready.

Grant the required permission

Enable the exact local app in System Settings → Privacy & Security → Accessibility. Rebuilding can change the app identity and require you to grant the rebuilt copy again. Mac Prompt Rewriter’s hotkey does not request permission automatically.

Connect Codex

Sign in with ChatGPT through the supported Codex App Server flow, then open Mac Prompt Rewriter Settings → Connection. Mac Prompt Rewriter does not copy login credentials. The launch scope is draft-first; contextual history remains disabled until account-isolation behavior is verified in a shipped release.

If macOS blocks the local build

Stop and use Apple’s normal documented security and development workflow. This guide does not instruct you to disable Gatekeeper, remove quarantine metadata, weaken signing, or bypass a macOS warning. A signed and notarized distribution path remains a separate release gate.

Before relying on it

Run the repository’s focused checks, keep an unchanged copy of any important draft, and treat local builds as experimental. Read the setup guide and troubleshooting guide before using the app.