Moviw

Codex Statusline — Development skill for Claude Code

Development community

Status bar for Codex CLI and Claude Code: context, 5h/weekly quota with reset times, tokens.

How to install Codex Statusline

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Moviw/codex-statusline and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Codex Statusline does

Status bar for Codex CLI and Claude Code: context, 5h/weekly quota with reset times, tokens.

Alternatives in Development

10 Statusline Setup Agent — Status Line Setup Agent System Prompt 2.3k ★
Mcptoon — Listing 255 MCP tools costs 71,929 tokens 195 ★
Tempest — Agentic Engineering that actually scales 161 ★

README

codex-statusline

**See your Codex and Claude Code context and quota at a glance.**

[![tests](https://github.com/Moviw/codex-statusline/actions/workflows/tests.yml/badge.svg)](https://github.com/Moviw/codex-statusline/actions/workflows/tests.yml) [![PyPI](https://img.shields.io/pypi/v/codex-statusline?label=PyPI)](https://pypi.org/project/codex-statusline/) [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

English | [简体中文](README.zh-CN.md)

A status bar for [OpenAI Codex CLI](https://github.com/openai/codex) and [Claude Code](https://code.claude.com). It shows context used, 5-hour and weekly quota left with reset times, and session tokens. You keep running `codex` and `claude` exactly as before.

![codex-statusline demo](docs/demo.gif)

Why

No more /status interruptions. Quota and context sit in view while you work.
Local data only. Never reads auth.json, never calls a quota API, never makes extra model calls. The one network request is a version check against PyPI when codex starts (turn off with update_check = false).
Zero new habits. Keep typing codex. codex exec, pipes, and scripts pass straight through to the official binary.
Always current. Quota is account-wide, so the freshest reading from any of your local Codex sessions is shown, and the bar flips to 100% the moment a window resets. Unknown shows as --, never a made-up number.
Fits any width. Segments collapse, then drop, as the terminal narrows.

Install

Requires macOS or Linux, [tmux](https://github.com/tmux/tmux), and Codex CLI ≥ 0.159.0. Bash, Zsh, and Fish are all detected automatically.

curl -fsSL https://raw.githubusercontent.com/Moviw/codex-statusline/main/install.sh | sh

The script installs [uv](https://docs.astral.sh/uv/) if needed (uv also fetches Python 3.11+ for you), installs the tool, then shows you the exact shell/hook diff and asks before writing anything.

Prefer to do it yourself: