Capture the ChatGPT app

Codex doesn’t only run in a terminal — and now paper doesn’t need it to. paperctl plugin install codex-app points Codex’s shared configuration at the local paperd proxy and delivers the plugin the app loads, so the ChatGPT desktop app, the IDE extension, and ordinary codex launches all route through paper persistently. Codex keeps using its own ChatGPT sign-in; paperd never holds your OpenAI credential.

paperctl plugin install codex-app --dry-run   # preview what would change
paperctl plugin install codex-app             # apply it, then finish in the app

Codex gates two steps on you, and the install summary lists them: enable the Paper plugin in the app’s Installed row, then run /hooks to trust its hooks. Trust binds to the exact hook-definition hash, so a plugin upgrade re-requires it. Restart the app afterward.

The command is safe to run repeatedly: it updates only the values paper owns, preserves everything else in Codex’s config, and doubles as the repair path when a Codex update rewrites its settings. paperctl plugin uninstall codex-app is its inverse.

Terminal launches keep working exactly as before: paperctl start codex configures a single launch without touching the shared config.

The verb is plugin install <harness> — the same surface tapesctl has, so what you learn about one client transfers to the other.

Get the latest CLI with paperctl upgrade, then see Capture the ChatGPT app for the walkthrough.