Codex Shortcut

Turn your Codex into Claude Cowork in a second.

Codex Shortcut gives Codex a Spotlight-style layer so you can trigger work from anywhere, keep moving, and monitor progress from a lightweight desktop surface.

Press Cmd+Shift+C, describe the task, and let Codex handle work in the background while you stay in your current app. The goal is not just faster coding prompts, but a quicker way to use Codex for everyday tasks like research, summaries, writing, filing, and other non-coding work.

Acknowledgements

This project was influenced by CodexMonitor. Thanks to the CodexMonitor project for helping push the shape of a better desktop experience around Codex workflows.

Why It Exists

Codex Shortcut makes Codex feel immediate, ambient, and useful throughout the day:

• Summon it anywhere: press Cmd+Shift+C and start a task instantly from whatever app you are in.
• Follow progress live: watch work move from queued to running to finished in real time.
• Use it beyond coding: hand off research, writing, summaries, filing, data cleanup, and other everyday tasks.

How To Use

1. Press Cmd+Shift+C from anywhere on your desktop.
2. Type what you need in plain language.
3. Hit Enter and go back to what you were doing.
4. Follow the live tray as Codex works.
5. Open the result, copy the output, or jump into the task artifacts when it finishes.

Use Case Showcase

Analyze local receipts and invoices into a report

Drop in a request to analyze local receipts and invoices, then let Codex turn the source material into a clean report while you keep working.

Find an SF studio under $3k and build a narrative

Ask Codex to find San Francisco studio apartments under $3k, compare options, and turn the results into a narrative you can actually review and share.

What You Get

Floating Composer

• Transparent, borderless, always-on-top prompt window.
• Global summon shortcut with Cmd+Shift+C.
• Esc to dismiss, plus auto-hide when you switch spaces.
• Auto-resizing input with one-keystroke submit.
• Built-in path autocomplete for /, ~/, ./, and ../.

Live Task Workflow

• Real-time tray updates for Queued, Running, Finished, Cancelled, and Failed tasks.
• Toolbar controls for model selection and reasoning effort.
• Stop in-flight tasks without leaving the composer.
• Semantic task naming so sessions are easier to scan than raw prompts.
• Markdown rendering for responses, including links, images, and local file paths.

Artifacts And Persistence

• One artifact directory per task under the configured artifacts root.
• Local session persistence so recent work survives relaunches.
• Active and past task views with elapsed time, prompt copy, and open-artifacts actions.

Settings

• In-app popover for endpoint, artifacts root, history limit, and Codex binary path.
• Model picker for fast and deeper Codex-capable models.
• Reasoning effort controls: low, medium, high, extra-high.
• Automatic bootstrap for a local Codex server when using the default endpoint.

Good Fits

Use Codex Shortcut when you want fast access to Codex for:

• Everyday coding tasks like debugging, refactors, code search, and file edits.
• Non-coding tasks like summaries, web research, reports, and structured writeups.
• Background jobs you want to launch quickly and monitor without context switching.

Dependencies

If you want to build Codex Shortcut locally, make sure you have:

• npm for the frontend and development scripts
• Rust and cargo for the Tauri desktop app
• Codex CLI installed locally; the default Codex bin path in Settings assumes /usr/local/bin/codex

Getting Started

Before anything else, run the following to find your local Codex binary:

which codex

After you launch the app, open the Settings panel and point Codex bin path to that location. The default path is /usr/local/bin/codex.

Install dependencies:

npm install

Start the full app in development:

npm run tauri:dev

If Codex is not already running at ws://127.0.0.1:4501, the app will launch it automatically. To start it yourself:

codex app-server --listen ws://127.0.0.1:4501

For frontend-only work without compiling the Rust backend:

npm run dev

Publish A GitHub Release

Build the signed DMG first so the bundle exists under src-tauri/target/release/bundle/dmg:

npm run tauri:build:mac

Then publish the newest DMG to GitHub Releases with the GitHub CLI:

gh auth login
npm run release:github -- --draft --generate-notes

The release script will:

• use the latest .dmg in src-tauri/target/release/bundle/dmg
• use tag v<version> from package.json and src-tauri/tauri.conf.json
• upload a matching .sha256 checksum file beside the DMG

Useful variants:

npm run release:github -- --notes-file RELEASE_NOTES.md
npm run release:github -- --tag v0.1.1-beta.1 --prerelease
npm run release:github -- --dry-run

Configure Settings

After the app is running, open Settings to confirm the local Codex setup and adjust the defaults for your workflow.

• Codex server endpoint: defaults to ws://127.0.0.1:4501.
• Artifacts root: where task outputs and generated files are stored.
• Past tasks limit: controls how much history stays visible in the tray.
• Codex bin path: defaults to /usr/local/bin/codex; update this if your Codex CLI is installed elsewhere.

In most local setups, the endpoint and bin path are the only fields you need to verify before starting work.

License

MIT. See LICENSE.