npm - cxstatusline - Versions diffs - 0.12.0 → 0.13.0 - Mend

cxstatusline 0.12.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md +52 -180
package/dist/cxstatusline.js +2 -2
package/package.json +1 -1
package/patches/codex-0.160.0.patch +1683 -0
package/patches/manifest.json +7 -1

package/README.md CHANGED Viewed

@@ -2,7 +2,7 @@
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="docs/banner-dark.png">
-  <img alt="cxstatusline - Customizable statusline & powerline status bar for OpenAI Codex CLI" src="docs/banner-light.png" width="720">
+  <img alt="cxstatusline - Customizable statusline & status bar for OpenAI Codex CLI" src="docs/banner-light.png" width="720">
 </picture>
 # cxstatusline
@@ -23,31 +23,17 @@
 </div>
-## 📑 Table of Contents
-- [✨ Features](#-features)
-- [🌐 Interactive Web Playground](#-interactive-web-playground)
-- [📋 Requirements](#requirements)
-- [🚀 Install](#-install)
-- [🎛️ Configure](#️-configure)
-- [🧩 Widgets Catalog](#widgets)
-- [🔄 Update, Upgrade & Revert](#update)
-- [🔍 How it Works](#-how-it-works)
-- [🏷️ Supported Versions](#supported-versions)
-- [🩺 Troubleshooting](#-troubleshooting)
-- [🙏 Acknowledgments](#-acknowledgments)
 ## ✨ Features
-**cxstatusline** is a configurable, one-to-three-row statusline & status bar for the [OpenAI Codex CLI](https://github.com/openai/codex) (bringing the rich statusbar experience of [ccstatusline](https://github.com/sirmalloc/ccstatusline) for Anthropic Claude Code to OpenAI Codex).
+**cxstatusline** is a configurable, multi-row statusline & status bar for the [OpenAI Codex CLI](https://github.com/openai/codex).
-- **⚡ Live Codex Telemetry**: Monitor active model, reasoning effort, context token window usage (`k/200k`), session duration, and rate limit reset countdowns in real time.
-- **🌿 Git Status & Branch**: Always see current branch and unstaged/staged change counters (`+42, -10`) right in your Codex prompt.
+- **⚡ Live Codex Telemetry**: Monitor active model, reasoning effort, context token window (`k/200k`), session duration, and rate limit reset countdowns in real time.
+- **🌿 Git Status & Branch**: Always see current branch and unstaged/staged change counters (`+42, -10`) directly in your Codex prompt.
 - **🎨 Powerline Themes & ANSI Colors**: Choose from built-in Powerline separators (arrows, angled, curved, flame), 16/256/TrueColor palettes, or design custom rows.
 - **🖥️ Interactive Terminal TUI**: Configure your layout visually inside your terminal (`cxstatusline`) or in the web playground.
-- **🔄 ccstatusline Compatibility**: Preset syntax and widget IDs match ccstatusline, making transition from Claude Code seamless.
+- **🧩 36 Built-in Widgets**: From token speed to session clocks, working directory, and custom shell command outputs.
-Independent project; not an official OpenAI product.
+*Note: cxstatusline is an independent open-source project and is not affiliated with or endorsed by OpenAI.*
 ## 🌐 Interactive Web Playground
@@ -61,18 +47,16 @@ Try out themes, arrange widgets, and preview your custom OpenAI Codex statusline
 </details>
-## Requirements
+## 📋 Requirements
-- **macOS 14 (Sonoma) or newer** (Apple Silicon or Intel) or **Linux** (x86_64 or aarch64).
+- **macOS 14 (Sonoma)+** (Apple Silicon or Intel) or **Linux** (x86_64 or aarch64).
 - **Node.js 22+**.
-- **Existing Codex CLI installation** kept in place (`~/.codex/`).
-- **Git**.
-- **Rust toolchain** (1.95.0+) and **Python 3.10+** are required only if building from source (`--compile`): Codex's package is assembled by upstream's own Python packager. On Linux, `--compile` also needs `bwrap` (bubblewrap) on `PATH` or `libcap-dev` + `pkg-config` to build it.
-- Prebuilt installs need nothing beyond Node.
+- **Existing Codex CLI installation** (`~/.codex/`).
+- Prebuilt installs require no extra dependencies beyond Node.js.
-## 🚀 Install
+## 🚀 Quick Start
-Install globally with npm:
+Install globally with npm and run the interactive setup:
 ```sh
 npm install -g cxstatusline
@@ -80,47 +64,24 @@ cxstatusline install
 cxstatusline doctor
 ```
-`cxstatusline install` downloads the verified prebuilt binary matching your Codex version, verifies checksums against `manifest.json`, and activates it.
-- **Interactive selection**: Running `cxstatusline install` opens a keyboard-driven version picker. Use ↑/↓ and Enter to select, or Escape/Ctrl+C to cancel. Prebuilt availability is shown per version; source-only choices require confirmation (unless you already passed `--compile`).
-- **Upgrade choices**: `cxstatusline upgrade` uses the same keyboard controls to choose the latest supported prebuilt, a supported source build, or cancellation. It does not update upstream Codex first.
-- **Live progress**: Ink renders download progress in terminals while completed stages remain in the transcript. Source builds report their phases; redirected output retains plain milestone logs.
-- **Target a specific version**: `cxstatusline install --codex-version <version>` (e.g. `cxstatusline install --codex-version 0.158.0`).
-- **Non-interactive / CI**: Pass `-y` or `--yes` to accept the default without prompting.
-Start Codex, accept its cxstatusline hook trust prompt, and open a new session after installation. An already-running process does not switch binaries when installation finishes.
-<details>
-<summary>Install from git checkout</summary>
-```sh
-git clone https://github.com/adrijshikhar/cxstatusline.git
-cd cxstatusline
-bun install --frozen-lockfile
-bun run link:local
-export PATH="$HOME/.local/bin:$PATH"
-cxstatusline install
-cxstatusline doctor
-```
+- **Interactive Selection**: `cxstatusline install` opens a keyboard-driven version picker showing verified prebuilts matching your Codex release.
+- **Target a Version**: Target a specific version directly with `cxstatusline install --codex-version <version>` (e.g. `cxstatusline install --codex-version 0.159.3`).
+- **Non-Interactive / CI**: Pass `-y` or `--yes` to accept defaults automatically.
-</details>
+After installation, start Codex and accept its hook trust prompt.
 <details>
 <summary>Build from source instead</summary>
-If you prefer to compile the patched Codex binaries locally from source:
+If you prefer to compile patched Codex binaries locally from source:
 ```sh
 rustup toolchain install 1.95.0 --component clippy --component rustfmt --component rust-src
-git clone https://github.com/adrijshikhar/cxstatusline.git
-cd cxstatusline
-bun install --frozen-lockfile
-bun run link:local
-export PATH="$HOME/.local/bin:$PATH"
+npm install -g cxstatusline
 cxstatusline install --compile
 cxstatusline doctor
 ```
-`install --compile` clones the exact upstream tag for your Codex version into `~/.local/share/cxstatusline/codex/`, applies the tested patch, builds both `codex` and `codex-code-mode-host`, verifies them, and activates them. Local compilation requires at least 20 GiB of free disk space and takes tens of minutes on a cold build.
+*(Requires Rust 1.95.0+, Python 3.10+, and ~20 GiB free disk space).*
 </details>
@@ -130,154 +91,65 @@ cxstatusline doctor
 cxstatusline
 ```
-The bare command opens the configuration TUI in an interactive terminal. Choose widgets, colors
-and themes, preview, then save explicitly or press Ctrl+S. Settings live at
-`~/.config/cxstatusline/settings.json` (or your XDG config location).
-For scripts, `cxstatusline render` reads a versioned JSON payload on stdin and prints ANSI rows;
-it never opens the TUI.
-## Widgets
+Running `cxstatusline` opens the interactive configurator TUI right in your terminal. Select widgets, change colors and Powerline symbols, preview changes live, and press `Ctrl+S` to save. Settings are stored at `~/.config/cxstatusline/settings.json`.
-36 widgets: model and thinking effort, Git branch and changes, context and token counts, token speed,
-5-hour and weekly usage and reset, session clock and name, working directory, terminal width, memory, plus three
-custom widgets that show your own text, symbol, or the output of a shell command.
+For automated scripting, `cxstatusline render` reads a JSON payload on stdin and prints ANSI strings without launching the TUI.
-Type IDs match ccstatusline's, so a ccstatusline preset imports without translation.
+## 🧩 Widgets Catalog
-👉 The full catalog, and how Custom Command handles timeouts, colours and background caching, are in
-the **[Usage guide](docs/usage.md)**.
+Includes 36 modular widgets across several categories:
+- **Telemetry & Models**: Active model, reasoning effort, context token progress, token speed (input/output/total).
+- **Git & Workspace**: Branch, dirty indicators, staged/unstaged diff stats, current working directory.
+- **Session & Limits**: 5-hour & weekly usage quotas, reset countdown timers, session clock, and duration.
+- **Custom Widgets**: Show your own static text, custom glyphs, or run arbitrary shell commands with background caching.
-## Update & Upgrade
+👉 See the **[Usage Guide (docs/usage.md)](docs/usage.md)** for full widget options, custom command caching, and color configuration.
-cxstatusline follows the Homebrew paradigm for managing updates:
-- **`cxstatusline update`**: Updates the **cxstatusline CLI tool itself** to the latest release (via npm, bun, or git).
-- **`cxstatusline upgrade`**: Upgrades the **patched Codex binary pair** to the latest supported release.
+## 🔄 Update, Upgrade & Revert
-### Updating cxstatusline (The Tool)
+cxstatusline follows the Homebrew paradigm:
 ```sh
-cxstatusline update          # Updates cxstatusline to the latest version
-cxstatusline update --check  # Checks for available tool updates without installing
-```
-`cxstatusline update` automatically detects your install method (`npm`, `bun`, or `git checkout`) and updates the CLI tool.
-### Upgrading Patched Codex
+# Update cxstatusline CLI tool
+cxstatusline update
-```sh
+# Upgrade patched Codex binary to the latest supported release
 cxstatusline upgrade
-```
-`cxstatusline upgrade` downloads and verifies the latest published prebuilt supported by your cxstatusline package, then activates the complete patched Codex pair. It does not run Codex's self-updater or modify your original Codex installation. Open a new Codex session afterward.
-The same Codex version is checked for rebuilt patch assets; a newer installed version is never downgraded. If discovery or verification fails, the active pair stays in place. When running `upgrade`, if a newer version of `cxstatusline` is available, it will display a friendly reminder to run `cxstatusline update` first.
-Options:
-- `cxstatusline upgrade --compile`: builds the latest locally supported Codex patch from source instead.
-- `--force`, `-y`, and `--yes` remain accepted for compatibility; updates already run without a prompt and always verify the pair.
-- Note: Running `cxstatusline update --compile` or `--force` will automatically forward to `cxstatusline upgrade` with a notice.
-Session-start updates also leave a newer patched pair in place when the original Codex installation is older, including under the `every` policy.
-#### The app-server daemon (Codex 0.157 and newer)
-Codex now starts a shared background app-server daemon and copies the package it was started from into `~/.codex/packages/app-server-daemon/`. cxstatusline installs Codex as that complete package (upstream's own layout: `bin/`, `codex-path/rg`, `codex-resources/`, `codex-package.json`), so the daemon starts normally. The daemon keeps and updates its own copy independently of cxstatusline; the statusline patch runs in the TUI process and is unaffected. `cxstatusline doctor` shows the daemon's copy as `daemon_package`; if its version drifts from the active generation, run `codex app-server daemon restart`. To run without the daemon: `codex --no-daemon`, or `[features] daemon_auto_start = false` in `~/.codex/config.toml`.
-Installs made by cxstatusline 0.10.x and older were bare binaries; the session-start hook rebuilds such an install once in the background, or run `cxstatusline upgrade`. Releases published from this version on cannot be read by cxstatusline 0.10.x: update with `npm i -g cxstatusline`.
-## Revert
-```sh
+# Safely revert and restore your original stock Codex launcher
 cxstatusline revert
 ```
-`cxstatusline revert` restores the stock launcher, removes CX-owned executables, generations, and the hook, and keeps settings and source. Generations are kept until revert; close Codex sessions first.
+- `cxstatusline update`: Checks for and updates the CLI tool via npm, bun, or git.
+- `cxstatusline upgrade`: Downloads and verifies the latest published prebuilt for your Codex installation.
+- `cxstatusline revert`: Restores the original unmodified Codex binaries and removes all cxstatusline hooks and generations.
-## 🔍 How it works
-Codex CLI does not yet provide a native statusline extension hook ([openai/codex#17827](https://github.com/openai/codex/issues/17827)). `cxstatusline` bridges this with a lightweight additive Rust patch that captures session telemetry (model, context tokens, Git branch, rate limits) and invokes a local Node/TypeScript ANSI renderer.
-Updates use an immutable **generation-based layout** (`~/.local/libexec/cxstatusline/generations/`) with atomic symlink swaps, ensuring your active terminal sessions are never interrupted.
-👉 For a full architectural breakdown of how Codex is patched with Rust, check out the **[Architecture & Technical Deep Dive (wiki.md)](wiki.md)**.
-## Supported versions
+## 🏷️ Supported Versions
-cxstatusline matches exact stable releases of OpenAI Codex.
+cxstatusline supports official releases of the OpenAI Codex CLI on macOS and Linux.
-### Latest Supported Version
-| Codex Target | Prebuilt Release | Supported Architecture | Status |
-|---|---|---|---|
-| **0.158.0** | [`codex-v0.158.0`](https://github.com/adrijshikhar/cxstatusline/releases/tag/codex-v0.158.0) | Apple Silicon (`darwin-arm64`), Linux ARM64 (`linux-arm64`) | ✅ Verified Prebuilt |
+👉 **View the full interactive list**: **[cxstatusline.adrijshikhar.dev/#compatibility](https://cxstatusline.adrijshikhar.dev/#compatibility)**
-<details>
-<summary><b>Previous Supported Versions</b></summary>
-<br>
-| Codex Target | Prebuilt Release | Supported Architecture | Status |
-|---|---|---|---|
-| **0.157.0** | [`codex-v0.157.0`](https://github.com/adrijshikhar/cxstatusline/releases/tag/codex-v0.157.0) | Apple Silicon (`darwin-arm64`), Linux ARM64 (`linux-arm64`) | ✅ Verified Prebuilt |
-| **0.156.1** | [`codex-v0.156.1`](https://github.com/adrijshikhar/cxstatusline/releases/tag/codex-v0.156.1) | Apple Silicon (`darwin-arm64`), Linux ARM64 (`linux-arm64`) | ✅ Verified Prebuilt |
-| **0.156.0** | [`codex-v0.156.0`](https://github.com/adrijshikhar/cxstatusline/releases/tag/codex-v0.156.0) | Apple Silicon (`darwin-arm64`), Linux ARM64 (`linux-arm64`) | ✅ Verified Prebuilt |
-| **0.155.1** | [`codex-v0.155.1`](https://github.com/adrijshikhar/cxstatusline/releases/tag/codex-v0.155.1) | Apple Silicon (`darwin-arm64`), Linux ARM64 (`linux-arm64`) | ✅ Verified Prebuilt |
-| **0.155.0** | [`codex-v0.155.0`](https://github.com/adrijshikhar/cxstatusline/releases/tag/codex-v0.155.0) | Apple Silicon (`darwin-arm64`), Linux ARM64 (`linux-arm64`), Linux x64 (`linux-x64`) | ✅ Verified Prebuilt |
-| **0.154.0** | [`codex-v0.154.0`](https://github.com/adrijshikhar/cxstatusline/releases/tag/codex-v0.154.0) | Apple Silicon (`darwin-arm64`) | ✅ Verified Prebuilt |
-| **0.153.4** | [`codex-v0.153.4`](https://github.com/adrijshikhar/cxstatusline/releases/tag/codex-v0.153.4) | Apple Silicon (`darwin-arm64`) | ✅ Verified Prebuilt |
-| **0.153.0** | [`codex-v0.153.0`](https://github.com/adrijshikhar/cxstatusline/releases/tag/codex-v0.153.0) | Apple Silicon (`darwin-arm64`) | ✅ Verified Prebuilt |
-| **0.152.1** | [`codex-v0.152.1`](https://github.com/adrijshikhar/cxstatusline/releases/tag/codex-v0.152.1) | Apple Silicon (`darwin-arm64`) | ✅ Verified Prebuilt |
-To install a specific version:
-```sh
-cxstatusline install --codex-version 0.157.0
-```
-</details>
+You can also run `cxstatusline install` at any time to browse supported releases interactively in your terminal. If your version isn't listed, you can [request support on GitHub](https://github.com/adrijshikhar/cxstatusline/issues/new?template=request-version.md).
-Rust patch versions are independent of Codex and cxstatusline package versions. Each supported Codex version belongs to exactly one patch version:
+## 🔍 How it Works
-| Rust patch | Tested Codex versions |
-| --- | --- |
-| v1 | 0.152.1, 0.153.0, 0.153.4, 0.154.0, 0.155.0, 0.155.1 |
-| v2 | 0.156.0, 0.156.1, 0.157.0, 0.158.0, 0.159.0, 0.159.3 |
+OpenAI Codex does not yet provide a native statusline extension API ([openai/codex#17827](https://github.com/openai/codex/issues/17827)). `cxstatusline` bridges this with a lightweight additive Rust patch in `codex-tui` that extracts runtime session telemetry (model, tokens, Git branch, rate limits) and sends it over stdio to a high-performance local TypeScript ANSI renderer.
-`patches/manifest.json` records that ownership with `patchVersion` on each compatibility entry. Its `version: 2` is the manifest format, not the Rust patch version. Entries can describe inclusive ranges, but we currently list only the exact tested versions. Version-specific patch files remain separate because upstream source layouts differ.
+Updates use an immutable **generation-based directory layout** (`~/.local/libexec/cxstatusline/generations/`) with atomic symlink swaps, ensuring active terminal sessions are never interrupted.
-Add newly tested Codex versions to the existing patch version while it continues to work. When a newer Codex needs a changed Rust integration, introduce the next patch version for that Codex version and future compatible releases. Do not backport it or reassign older Codex versions. Overlapping entries are rejected.
+👉 For full architectural diagrams and deep dive, see **[wiki.md](wiki.md)**.
-New builds record the patch version in release and installation metadata; `cxstatusline doctor` displays it. Older releases remain readable and report `unknown (legacy)` rather than guessing. New prebuilt manifests use schema 2, so installing them requires a cxstatusline package that supports this format. Release tags remain `codex-v<version>`.
-Rebuilding an existing Codex tag replaces its complete release asset set. The workflow verifies the new build, downloads and verifies every old asset, and saves a 90-day workflow artifact before mutation. The Git tag remains; the release may be briefly unavailable while the replacement is uploaded and verified. If automatic recovery fails, download the matching `release-backup-<tag>-<run-id>` artifact and restore it with `bun scripts/prebuilt.ts restore --tag codex-v0.156.1 --codex-version 0.156.1 --backup-dir ./release-backup --repo adrijshikhar/cxstatusline`.
+## 🩺 Troubleshooting
-If your Codex version is not listed, cxstatusline fails closed: it will neither download an unverified prebuilt nor attempt source compilation. New versions require a tested patch file, an entry in `patches/manifest.json`, and a release workflow run.
+- **No statusline visible?** Run `cxstatusline doctor`, verify `which codex` points to `~/.local/bin/codex`, check your `PATH`, accept the hook prompt inside Codex, and restart your terminal session.
+- **Interrupted installation?** Run `cxstatusline doctor`. You can run `cxstatusline revert` at any time to safely restore stock Codex before reinstalling.
+- **Diagnostics**: Run `cxstatusline doctor` to inspect active generation symlinks, daemon status, and binary checksums.
-The daily upstream watcher audits every stable release in the newest Codex major.minor series and only the `.0` baseline of older series, at or above the support floor. For example, while 0.159.x is newest, 0.159.0 is required alongside 0.158.0, 0.157.0, 0.156.0, and 0.155.0; 0.155.1 is not a backfill requirement. Existing published assets and tested compatibility mappings are retained. It updates one `Codex release coverage gaps` issue and uploads a machine-readable report. A separate watchdog fails if no successful scheduled watcher run has completed in the last 36 hours. Enable repository **Settings → Notifications → Actions** and select failed workflow runs (or enable email notifications for Actions) to receive these failures. The watchdog runs inside GitHub Actions, so a GitHub-wide scheduling outage cannot be detected from within GitHub.
-## 🩺 Troubleshooting
-- **No footer:** Run `cxstatusline doctor`, verify `which codex` points to `~/.local/bin/codex`, check your `PATH`, accept the hook prompt in Codex, and start a fresh session.
-- **Unsupported version:** Wait for an explicitly supported patch. `--force` does not bypass version compatibility. Keep a working stock Codex installation.
-- **Failed build:** Inspect `~/.local/state/cxstatusline/patch.log`, fix the prerequisite, then run `cxstatusline patch --force`. Redact personal paths, session identifiers, and secrets before sharing logs.
-- **Missing companion / interrupted install:** Run `cxstatusline doctor`. Use `cxstatusline revert` to return to stock before reinstalling if unhealthy. Do not manually replace only one binary.
 ## 🙏 Acknowledgments
-Huge shout-out to **[ccstatusline](https://github.com/sirmalloc/ccstatusline)** by [@sirmalloc](https://github.com/sirmalloc)! The interactive configurator TUI, widget architecture, Powerline themes, and overall statusline UX in `cxstatusline` are directly adapted and inspired by `ccstatusline`'s fantastic work for Claude Code.
-## License
-cxstatusline is [MIT licensed](LICENSE). See [SECURITY.md](SECURITY.md) for security boundaries and reporting. [NOTICE](NOTICE) and [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) preserve upstream attribution. OpenAI Codex remains separately licensed under Apache-2.0.
----
-- 🌐 **Web Playground:** [cxstatusline.adrijshikhar.dev](https://cxstatusline.adrijshikhar.dev)
-- 💬 **Discussions & Ideas:** [github.com/adrijshikhar/cxstatusline/discussions](https://github.com/adrijshikhar/cxstatusline/discussions)
-- 📦 **npm Package:** [npmjs.com/package/cxstatusline](https://www.npmjs.com/package/cxstatusline)
+Huge shout-out to **[ccstatusline](https://github.com/sirmalloc/ccstatusline)** by [@sirmalloc](https://github.com/sirmalloc)! The interactive configurator TUI, widget architecture, Powerline themes, and overall statusline UX in `cxstatusline` are directly adapted and inspired by `ccstatusline`'s fantastic work for Claude Code.
-### Prebuilt build machine
+## 📄 License
-All Codex prebuilt jobs run on the owner's M5 Pro (`192.168.1.65`, Actions labels
-`self-hosted`, `macOS`, `ARM64`, `m5-pro`). macOS builds natively; Linux builds in
-Docker on that same M5. Keep the laptop and runner active until the workflow finishes.
-An offline M5 leaves jobs queued; there is no hosted fallback. Platform builds run
-sequentially, preserving 3 native Rust compiler jobs and 8 inside Docker. Dispatch from a ref containing this policy;
-older release tags may still contain the removed hosted-runner option.
+MIT © [Adrij Shikhar](https://github.com/adrijshikhar). See [LICENSE](LICENSE) for details. OpenAI Codex remains separately licensed under Apache-2.0.

package/dist/cxstatusline.js CHANGED Viewed

@@ -59035,8 +59035,8 @@ function runRefreshCommand(cacheKey2, deps) {
   return 0;
 }
 // src/version-info.ts
-var VERSION = "0.12.0";
-var SOURCE_COMMIT = /^[0-9a-f]{40}$/.test("69ccf6828b54b05fb135f113c3b0bf3a56ce8b35") ? "69ccf6828b54b05fb135f113c3b0bf3a56ce8b35" : null;
+var VERSION = "0.13.0";
+var SOURCE_COMMIT = /^[0-9a-f]{40}$/.test("4e5293425d1f37dde096fb5a49ebfd3b67fd62bb") ? "4e5293425d1f37dde096fb5a49ebfd3b67fd62bb" : null;
 var SOURCE_DIRTY = false;
 // src/context.ts

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "cxstatusline",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Customizable statusline for OpenAI Codex CLI",
   "license": "MIT",
   "repository": {