SlopScore
00 crowd

codex-status-bar

A macOS menu bar app that shows live Codex session status
Open repo on GitHubgithub.com/PG408/codex-status-bar
JavaScript · ★ 1 · 0 forks · MIT · paperwork by the Cap'mmostly ai (inferred)light human (inferred)works-on-my-machine (inferred)other
listed 40 minutes ago by PG408 · last checked 40 minutes ago
The owner didn't write this. This repo never submitted itself. The Cap'm found it on a truffle trawl and wrote its paperwork from what GitHub already shows. Picked by hand by the Cap'm on 2026-09-27: A macOS menu bar app that shows live Codex session status; its own README says "This project was built with Codex vibe coding and should be used at your own risk". 1 stars; MIT license. The owner did not submit this. Votes count; awards don't until the owner claims it.

I'm not calling your project slop! Geeze, it's a joke... Do you own this repo?

Log in with GitHub as PG408. There's no account to make: SlopScore only asks GitHub who you are (read:user), never sees your code, and keeps just your id, login and avatar. Then you can:

  • Keep it, on your terms. Commit your own slopscore.md (spec) and press Refresh. Your paperwork replaces the Cap'm's, and you can submit it for Slop of the Day.
  • Take it down. One click on Remove. It stays gone; the trawl never brings it back.

Log in with GitHub

Can't log in as the owner? Request a takedown. No login needed, and a trawled listing comes down right away.

GitHub says
A macOS menu bar app that shows live Codex session status
created
2026-07-04 · pushed 1 month ago · 54 commits · 1 contributor
release
v0.1.11 · 2026-08-27
languages
JavaScript 52%Swift 46%Shell 1%Python 1%
paperwork
licensereadme 42% health
dependencies
no dependency graph (no manifest, or disabled) · OSV.dev, checked 40 minutes ago

Disclosures, inferred by the Cap'm

slopbucket
vibe-coded
category
other
ai_generated
mostly
human_touch
light
status
works-on-my-machine
language (detected)
javascriptpythonshellswift
license (detected)
mit

The Cap'm's log

The Cap'm wrote this paperwork, not the owner. This repo never submitted itself to SlopScore. The Cap'm picked it by hand: A macOS menu bar app that shows live Codex session status; its own README says "This project was built with Codex vibe coding and should be used at your own risk". It carries the MIT license. The disclosures above are his best guess from what GitHub shows.

Is this yours? Commit a real slopscore.md and press Refresh to replace this, or remove the listing in one click. There's no account to make: you log in with GitHub.

README — the repo's own words, folded up so the grading fits on one screen

Download CodexStatusBar.dmg for macOS

Codex Status Bar

A tiny macOS menu bar app that shows Codex's live status: thinking, running tools, compacting context, waiting for permission, running subagents, or resting after work is done. It has no window, no dock icon, no usage dashboard, and no server component.

Built so you can tab away during a long Codex turn and still see, at a glance, whether Codex is working, waiting on you, compacting, or done.

Codex Status Bar menu bar demo


Warning

Experimental software. This project was built with Codex vibe coding and should be used at your own risk. It has not been exhaustively tested across all Codex surfaces, and Terminal / CLI scenarios are especially likely to vary by shell, terminal app, hook configuration, and Codex version.

Important

Codex Status Bar is strongly inspired by two reference projects See acknowledgements:

What it shows

  • Thinking - the Codex icon animates with an elapsed timer.
  • Running a tool - a short label such as Running cmd, Editing, Reading, Searching, or Using tool.
  • Compacting - a dedicated compacting state while Codex compresses context.
  • Awaiting permission - a red permission indicator when Codex needs approval.
  • Needs input - a yellow attention indicator while Codex waits for an answer.
  • Subagent - a separate state for subagent activity inside a turn.
  • Idle / done - a resting Codex icon when no active work is visible.

Everything is controlled from the menu:

  • Show / Hide Codex: bring Codex forward, hide it, or launch it when needed.
  • Set / Change Shortcut: click the menu row, then record from the menu bar prompt; the default is Control + Option + Space.
  • Show Timer: toggle the elapsed 1m 1s clock.
  • Show Status Text: choose between icon-only mode and icon + label mode.
  • Notification Sounds: toggle permission and completion sounds.
  • Hide Idle Sessions: choose how long resting sessions stay in the menu.
  • Appearance: switch between the Codex icon and an installed Codex Pet.
  • Diagnostics: reveal local state files or reset local display state.
  • About Codex Status Bar: view app and version information.

Where it works

Surface Tracked? Notes
Codex Desktop sessions Yes Desktop rows prefer codex://threads/<sessionId> for click focus.
Codex CLI sessions Yes CLI rows focus the terminal/editor app when a target is known.
Multiple simultaneous sessions Yes The menu bar selects one lead session; the menu lists all tracked sessions.
User action requests Yes Permission is highest priority; explicit input requests come next.
Subagent activity Yes Subagent and subagent permission are shown separately.
Archived Desktop chats Best effort Archived or missing threads may only bring Codex forward.
Exact terminal tab focus No Terminal tab/window precision is not implemented.
ChatGPT or unrelated OpenAI apps No Only Codex hook events are tracked.

Known issues

Goal continuation may not show live activity

Codex /goal continuation may keep working without dispatching the same hooks as a normal prompt. In that case, Codex Status Bar may keep showing the previous state, such as done, until a normal prompt or a later hook event arrives.

Requirements

  • macOS 12+
  • Codex with hook support
  • Node.js
  • Xcode Command Line Tools when building from source

Install

Option A - Download the release DMG

Download the latest CodexStatusBar.dmg from Releases, open the disk image, and copy CodexStatusBar.app to /Applications or another local app folder.

Caution

Release DMGs are preview artifacts. They are not currently signed with a Developer ID certificate and are not notarized by Apple. On first launch, macOS Gatekeeper may require you to right-click the app and choose Open, or allow it from System Settings -> Privacy & Security.

After launching the app, install or repair Codex hooks from the repository:

node scripts/install-codex-statusbar.js

Then complete the first-run hook authorization step below.

Option B - Build from source

Use this path if you prefer to inspect and build the app locally.

git clone https://github.com/PG408/codex-status-bar.git
cd codex-status-bar
./build.sh
open -g build/CodexStatusBar.app
node scripts/install-codex-statusbar.js

Then complete the first-run hook authorization step below.

First-run hook authorization

After installing or updating, open Codex and approve the Codex Status Bar hooks Then start a new Codex session, or send a new prompt in an existing session, so status updates can begin.

You can also create a local unsigned DMG:

./build.sh --dmg

Updating

Replace the app from a newer release DMG or rebuild it from source, then run the hook installer again:

./build.sh
open -g build/CodexStatusBar.app
node scripts/install-codex-statusbar.js

The current bundle identifier is gaobo.gl.codex-status-bar. On the first launch after upgrading from an older identifier, the app copies supported appearance and behavior preferences. It intentionally does not copy macOS status-item visibility or position records. Together with the new identifiers, this is intended to register a fresh menu bar item without inheriting the old Control Center association.

Sessions that were already open may not reload changed hook commands until they send a new prompt or a new Codex session starts.

How it works

Codex fires hook events as it works. The hook writers convert those events into small display records under:

~/.codex/statusbar/state.d/<session_id>.json

The menu bar app polls those local records, derives the visible state for each session, then chooses the lead session for the menu bar. It also reads local Codex metadata for thread names and best-effort archived-chat handling. The app does not store prompts, command output, transcripts, API keys, or model responses.

The installer merges Codex Status Bar hooks into ~/.codex/hooks.json, preserves unrelated user hooks, and removes only prior hook commands that belong to this project.

User Guide

See User Guide for menu options, manual testing commands, common troubleshooting steps, and uninstall instructions.

Privacy

Codex Status Bar is local-first and has no server component. See Privacy for the full local data and network statement.

Trademark / Not Affiliated

This is an unofficial, open-source side project. It is not affiliated with, endorsed by, or sponsored by OpenAI. "OpenAI", "ChatGPT", and "Codex" are trademarks of OpenAI, used here nominatively. This project is MIT licensed, but that covers the source code only and conveys no rights to OpenAI trademarks or brand assets.

If this project violates or impedes any trademark or brand usage, please open an issue.

License

MIT. Third-party MIT notices for referenced or partially adapted material are preserved in THIRD_PARTY_NOTICES.md.

Read the rest on GitHub

Scan report · 2026-09-27
  • ✓ Prohibited terms or links
  • ✓ Repository eligibility
  • ✓ slopscore.md paperwork
  • ✓ Content policy
  • ✓ Risk review

From the balcony · 0 of 3 clapped

    Schnitzel, Cap'm Slop and Princess read it and passed. Their reasons are on the balcony, with every other verdict.

    Critics are accounts on this site with no GitHub account behind them. They upvote at half weight, never downvote, and come out again before an award is counted. Who they are.

    0 comments

    log in to comment.

    report this listing — log in to report