codex-statusline 0.2.1__tar.gz → 0.2.2__tar.gz

{codex_statusline-0.2.1 → codex_statusline-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-statusline
-Version: 0.2.1
+Version: 0.2.2
 Summary: A tmux statusline for OpenAI Codex CLI: context usage, 5h and weekly quota, and session tokens at a glance. Local-only.
 Author: Zimo Xu
 License-Expression: MIT
@@ -59,7 +59,7 @@ Prefer to do it yourself:
 
 ```sh
 uv tool install codex-statusline    # or: pipx install codex-statusline
-codex-statusline install            # add --dry-run to only preview the diff
+codex-statusline install            # add --dry-run to see the plan first
 ```
 
 Then **open a new terminal** and run `codex`. The first time, Codex asks you to review a hook: confirm it is `codex-statusline binding`.
@@ -76,7 +76,6 @@ codex exec 'task'         # non-interactive: passed straight through, no bar
 codex-statusline config   # pick segments, theme and colors interactively
 codex-statusline update   # upgrade, whichever way you installed it
 codex-statusline doctor   # check versions and dependencies
-codex-statusline preview --width 80   # try it without launching Codex
 codex-statusline uninstall
 ```
 

{codex_statusline-0.2.1 → codex_statusline-0.2.2}/README.md

@@ -38,7 +38,7 @@ Prefer to do it yourself:
 
 ```sh
 uv tool install codex-statusline    # or: pipx install codex-statusline
-codex-statusline install            # add --dry-run to only preview the diff
+codex-statusline install            # add --dry-run to see the plan first
 ```
 
 Then **open a new terminal** and run `codex`. The first time, Codex asks you to review a hook: confirm it is `codex-statusline binding`.
@@ -55,7 +55,6 @@ codex exec 'task'         # non-interactive: passed straight through, no bar
 codex-statusline config   # pick segments, theme and colors interactively
 codex-statusline update   # upgrade, whichever way you installed it
 codex-statusline doctor   # check versions and dependencies
-codex-statusline preview --width 80   # try it without launching Codex
 codex-statusline uninstall
 ```
 

{codex_statusline-0.2.1 → codex_statusline-0.2.2}/codex_statusline.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-statusline
-Version: 0.2.1
+Version: 0.2.2
 Summary: A tmux statusline for OpenAI Codex CLI: context usage, 5h and weekly quota, and session tokens at a glance. Local-only.
 Author: Zimo Xu
 License-Expression: MIT
@@ -59,7 +59,7 @@ Prefer to do it yourself:
 
 ```sh
 uv tool install codex-statusline    # or: pipx install codex-statusline
-codex-statusline install            # add --dry-run to only preview the diff
+codex-statusline install            # add --dry-run to see the plan first
 ```
 
 Then **open a new terminal** and run `codex`. The first time, Codex asks you to review a hook: confirm it is `codex-statusline binding`.
@@ -76,7 +76,6 @@ codex exec 'task'         # non-interactive: passed straight through, no bar
 codex-statusline config   # pick segments, theme and colors interactively
 codex-statusline update   # upgrade, whichever way you installed it
 codex-statusline doctor   # check versions and dependencies
-codex-statusline preview --width 80   # try it without launching Codex
 codex-statusline uninstall
 ```
 

{codex_statusline-0.2.1 → codex_statusline-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codex-statusline"
-version = "0.2.1"
+version = "0.2.2"
 description = "A tmux statusline for OpenAI Codex CLI: context usage, 5h and weekly quota, and session tokens at a glance. Local-only."
 requires-python = ">=3.11"
 license = "MIT"

{codex_statusline-0.2.1 → codex_statusline-0.2.2}/src/__init__.py

@@ -1,3 +1,3 @@
 """A local-only tmux status area for the official Codex CLI."""
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"

{codex_statusline-0.2.1 → codex_statusline-0.2.2}/src/cli.py

@@ -3,7 +3,6 @@ import json
 import os
 import shutil
 import sys
-import time
 from pathlib import Path
 
 from . import __version__
@@ -26,34 +25,34 @@ def main():
         record()
         return 0
     parser = argparse.ArgumentParser(
-        description="Third-party local tmux statusline for the official Codex CLI."
+        prog="codex-statusline",
+        description="A status bar for Codex CLI: context, 5h/weekly quota, and tokens. "
+        "Run `codex` as usual once installed.",
     )
     parser.add_argument("--version", action="version", version=__version__)
-    sub = parser.add_subparsers(dest="action", required=True)
+    sub = parser.add_subparsers(dest="action", required=True, metavar="<command>", title="commands")
+    commands = {
+        "install": "hook the status bar into `codex` for your shells",
+        "uninstall": "remove everything install added",
+        "config": "choose what the bar shows, interactively",
+        "update": "upgrade to the latest release",
+        "doctor": "check Codex, tmux, and Python versions",
+    }
+    parsers = {
+        name: sub.add_parser(name, help=text, description=text) for name, text in commands.items()
+    }
     for name in ("install", "uninstall"):
-        s = sub.add_parser(name)
+        s = parsers[name]
         s.add_argument(
             "--shell",
             choices=["auto", "bash", "zsh", "fish", "both", "all"],
             default="auto",
-            help="default: all supported shells found on PATH",
-        )
-        s.add_argument("--home", default=str(Path.home()), help="target home (for isolated tests)")
-        s.add_argument(
-            "--yes",
-            action="store_true",
-            help="apply without asking",
+            help="default: every supported shell found on PATH",
         )
+        s.add_argument("--home", default=str(Path.home()), help=argparse.SUPPRESS)  # tests
+        s.add_argument("--yes", action="store_true", help="apply without asking")
         s.add_argument("--diff", action="store_true", help="show the exact file changes")
-        s.add_argument("--dry-run", action="store_true")
-    sub.add_parser("doctor")
-    sub.add_parser("config", help="choose segments, theme and thresholds interactively")
-    sub.add_parser("update", help="upgrade codex-statusline the way it was installed")
-    p = sub.add_parser("preview")
-    p.add_argument("--width", type=int, default=120)
-    p.add_argument("--theme", choices=["auto", "dark", "light"])
-    p.add_argument("--ascii", action="store_true")
-    p.add_argument("--tmux", action="store_true", help="emit tmux style syntax, not ANSI")
+        s.add_argument("--dry-run", action="store_true", help="show the plan, change nothing")
     ns = parser.parse_args(args)
     try:
         if ns.action in ("install", "uninstall"):
@@ -81,32 +80,6 @@ def main():
             }
             print(json.dumps(data, indent=2))
             return 0 if data["tmux"] and version(path) >= (0, 159, 0) else 1
-        if ns.action == "preview":
-            from .render import load_config, render
-
-            cfg = load_config()
-            now = time.time()
-            state = {
-                "context_used": 35,
-                "tokens": 1_234_567,
-                "quotas": {
-                    "5h": {"remaining": 78, "reset_at": now + 7200, "observed_at": now},
-                    "weekly": {"remaining": 39, "reset_at": now + 172800, "observed_at": now},
-                },
-            }
-            print(
-                render(
-                    state,
-                    ns.width,
-                    theme=ns.theme or cfg["theme"],
-                    ascii_only=ns.ascii or cfg["ascii"],
-                    tmux=ns.tmux,
-                    segments=cfg["segments"],
-                    warn_at=cfg["warn_at"],
-                    crit_at=cfg["crit_at"],
-                )
-            )
-            return 0
     except (OSError, ValueError, RuntimeError, KeyError) as error:
         print(f"codex-statusline: {error}", file=sys.stderr)
         return 1

{codex_statusline-0.2.1 → codex_statusline-0.2.2}/src/render.py

@@ -278,7 +278,7 @@ def render(
     hint = None
     if isinstance(update, str) and re.fullmatch(r"\d+(\.\d+)*", update):
         arrow = "^" if ascii_only else "↑"
-        hint = (f"{arrow} {update} run: codex-statusline update", f"{arrow}{update}", "warning")
+        hint = (f"{arrow} update available: codex-statusline update", f"{arrow} update", "warning")
     head, rest = parts[0], parts[1:]
     compact_head = (head[1], head[2])
     # Widest first: all detail, compact head, all compact, then drop segments.

{codex_statusline-0.2.1 → codex_statusline-0.2.2}/tests/test_update.py

@@ -42,7 +42,7 @@ class UpdateTests(unittest.TestCase):
     def test_update_hint_is_dropped_first_when_narrow(self):
         state = {"context_used": 10, "now": 1000, "update": "0.2.0", "quotas": {}}
         wide = render(state, 240, tmux=False)
-        self.assertIn("↑ 0.2.0 run: codex-statusline update", wide)
-        self.assertIn("^0.2.0", render(state, 240, tmux=False, ascii_only=True).replace(" ", ""))
-        self.assertNotIn("0.2.0", render(state, 40, tmux=False))
-        self.assertNotIn("0.2.0", render(dict(state, update="#(evil)"), 240, tmux=False))
+        self.assertIn("↑ update available: codex-statusline update", wide)
+        self.assertIn("^ update available", render(state, 240, tmux=False, ascii_only=True))
+        self.assertNotIn("update", render(state, 40, tmux=False))
+        self.assertNotIn("update", render(dict(state, update="#(evil)"), 240, tmux=False))