npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

codex-sline

v0.1.1

Published

Status companion for OpenAI Codex CLI: hooks, renderer, installer, and project-aware session state.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

saschanesaschane

Keywords

codexcodex-cliopenaistatuslinehooksterminaltui

Readme

codex-sline

Status companion for OpenAI Codex CLI: shows model, context estimate, git branch, directory, and session ID in your terminal.

Requirements

  • Node.js >= 18
  • OpenAI Codex CLI installed and configured

Installation

Install the hooks into ~/.codex with a single command:

npx codex-sline@latest install

This merges the required hooks into ~/.codex/hooks.json, configures ~/.codex/config.toml, and copies the runtime files into ~/.codex/codex-sline. After installation, start a new Codex session to see a status summary at the top.

To display the same status in tmux, print the tmux snippet:

codex-sline tmux-config

Add the printed line to ~/.tmux.conf, then reload tmux:

tmux source ~/.tmux.conf

If you do not install the package globally, prefix commands with npx codex-sline@latest.

Usage

Verify installation:

npx codex-sline@latest doctor

Show current status as plain text:

npx codex-sline@latest render --plain

Tmux status bar:

Run codex-sline tmux-config to get a ready-to-paste snippet. Example output:

set-option -g status-right "#(node '~/.codex/codex-sline/bin/codex-sline.cjs' render --plain)"

The command prints the resolved install path for your machine.

Upgrade

npx codex-sline@latest upgrade

The upgrade command checks the installed version against the npm registry, downloads the latest release, and replaces the installed copy atomically. It is safe to run during an active Codex session because running hooks keep using the files already loaded by their process.

When an update is available, output looks like this:

Installed version: 0.1.0
Latest version:    0.1.1
Downloading... done
Installed to ~/.codex/codex-sline
Upgrade complete.

When the installed copy is current, it prints:

codex-sline is already up-to-date (0.1.0)

Limitations

  • Token estimate: The context field is an estimate derived from hook payload data, not from the OpenAI account API. It may differ from the actual token count.
  • Session ID: The session ID is truncated to 8 characters for display. It is not the full UUID.
  • No PR context: Pull request information is not shown in v1.
  • Weekly reset timer: OpenAI does not expose account reset times through the Codex hook API, so this tool does not display them.

Uninstall

npx codex-sline@latest uninstall

Uninstall removes only the hooks and config entries added by codex-sline. Third-party hooks, including memsearch and GSD hooks, are preserved.

Development

npm test
node bin/codex-sline.cjs render --plain
node bin/codex-sline.cjs doctor

License

MIT