PwrAgent

Why you might want this

• Code keeps moving when you're away from the keyboard

  Approvals, follow-up prompts, "what did you ship while I was at lunch" check-ins — all from your phone. The agent runs on your laptop where it belongs. Your messenger is the steering wheel, not the engine. Works fine on cellular and on hotel WiFi that drops every two minutes.

• Stack three asks and walk away

  Send make a branch and PR for the OAuth refactor, then queue /review main, then queue squash and force-push. The composer dispatches them FIFO, one turn at a time. You walk away. By the time you come back, three things are done.

• Isolated profiles for work, personal, side projects

  Open as many PwrAgent windows as you want, each on its own profile, each bound to its own Codex identity. Work threads in one Dock icon, personal in another, the side project in a third. Threads, authentication, and messaging credentials never cross.

• Works alongside Codex Desktop

  Shares thread state with Codex Desktop by default — start a thread in either app, finish it in the other. When you want isolation, profiles handle it. PwrAgent adds per-thread model / access / fast-mode controls, worktree isolation with handoff, a Markdown composer, and the messaging surface — things Codex Desktop doesn't have today.

• No cloud, no account, no telemetry

  PwrAgent runs entirely on your machine. State lives under ~/.pwragent/. Bot tokens go in the macOS Keychain. There's no PwrAgent-owned server in the loop — the messenger talks to your laptop, your laptop talks to Codex.

• Free, MIT-licensed, dogfooded

  The author uses it as their primary coding environment. Hundreds of PRs in this repository and others were created or reviewed through PwrAgent. It's signed, notarized, and free. The full source — Electron app, messaging adapters, replay test harness — is on GitHub.

How it works, in one paragraph

You install the desktop app. It pairs with your Codex installation and shares the same thread store, so any thread you start shows up in both. You open Settings → Messaging, pair a bot on one of six platforms with a one-time code (no IDs to look up, no JSON to paste), and from then on you can /resume an existing thread or /new a fresh one from your phone — review the agent’s last reply, send the next prompt, approve a Default-Access command, queue follow-ups for after the current turn finishes. When you’re back at your laptop the conversation picks up exactly where you left it.

Get it

• Download the latest signed macOS build directly: PwrAgent.dmg. Universal binary — runs natively on both Apple Silicon (M1+) and Intel Macs. Developer ID-signed and Apple-notarized, so first launch is a single Gatekeeper prompt — no right-click-open dance. The GitHub Releases page carries the version-tagged DMG, zip, and latest-mac.yml autoupdate manifest if you want those.
• Set up in 5 minutes — installer drag-and-drop, then Settings → Messaging → <your platform> to pair a bot. The docs walk through each platform end-to-end.
• Source is on GitHub at pwrdrvr/PwrAgent. MIT-licensed. Issues, patches, forks all welcome.
• Follow @PwrAgentAI for releases and behind-the-scenes.

What it isn’t

• Not a Codex replacement. PwrAgent sits alongside Codex Desktop and the Codex App Server. It uses Codex’s thread store, its authentication, its agent — and adds a desktop UI, messaging integration, profile isolation, per-thread controls, and a Markdown composer on top.
• Not a SaaS. No cloud relay, no account, no telemetry. Everything runs on your machine.
• Not VC-funded. Single contributor, MIT license, free.

PwrAgent is in beta. The desktop ships signed and notarized; the messaging surface and the desktop app are stable enough for daily use, with the author's own work depending on them. The honest roadmap lists what's still missing.