Skip to content
ccmods.app

cache-ttl-statusline

v1.6.1

Status line with model, cost, context bar, prompt cache TTL, 5h/7d usage bars and git state, drawable as a native mod band.

by @JerrettDavis4Updated Broad accessGitHub

Installation

  1. Install from your shell (answer y to add the marketplace)

    $ claude plugin install cache-ttl-statusline --marketplace JerrettDavis/ClaudeStatusLineWidgets

Already in a session? Type this at the Claude Code prompt:

$ /plugin install cache-ttl-statusline --marketplace JerrettDavis/ClaudeStatusLineWidgets

Pick a scope and the mod is active right away. Needs Claude Code 2.1.287 or later, in a terminal. Full install guide

What does cache-ttl-statusline do?

  • Default three lines: session info with cache TTL, 5h/7d rate-limit bars, and Headroom proxy savings
  • Context bar and cache TTL change colour from green to yellow to red as limits approach
  • /statusline-mode hook|mod switches between the classic statusLine and the native mod band
  • ccfooter-config TUI adds, removes, reorders and recolours widgets with a live preview
  • Layout saved in ~/.config/claude-statusline-widgets/settings.json

What do you need?

  • Claude Code 2.1.287 or later (terminal)
  • Node.js 22.12+

What can this mod access?

Read from the mod's code with claude plugin validate on Claude Code 2.1.296, synced Oct 12, 2026. This is a capability list, not a security audit. Mods run with your permissions, so install only from authors you trust.

Broad access
  • Runs programs on your machine
  • Writes files
  • Makes network requests
  • Reads files
  • Reads environment variables or settings
Hooks and engine calls (6 + 20)

hooks

  • classic.SessionStart
  • command.run{command=statusline-mode}
  • session.measure
  • session.start
  • turn.complete
  • ui.render{component=AbovePrompt}

calls

  • $.clock.after
  • $.clock.every
  • $.clock.now
  • $.command.register
  • $.env.get
  • $.fs.read
  • $.fs.stat
  • $.fs.write
  • $.http.fetch
  • $.process.run
  • $.session.cwd
  • $.session.id
  • $.session.model
  • $.session.usage
  • $.session.version
  • $.state.get
  • $.state.set
  • $.ui.invalidate
  • $.ui.log
  • $.ui.resolve

How do you uninstall cache-ttl-statusline?

$ claude plugin uninstall cache-ttl-statusline

To switch it off without removing it, use claude plugin disable with the same name.

Do you maintain cache-ttl-statusline?

Add this badge to your README so users can jump to this page for the install command and access report.

Listed on ccmods.app
[![Listed on ccmods.app](https://ccmods.app/badge.svg)](https://ccmods.app/mods/cache-ttl-statusline)

Related mods

cache-refresher

olddonkey/cache-refresher

3

Shows when the prompt cache expires and what a rebuild would cost, with an opt-in auto-refresh while you are away.

UICommandsWorkflowModerate access
$ claude plugin install cache-refresher --marketplace olddonkey/cache-refresher

prompt-cache-control

Nasrallah-Adel/claude-prompt-cache-control

1

Shows a prompt-cache meter above the prompt with hit rate and a countdown to expiry, and suggests /compact or /clear.

UIPromptCommandsBroad access
$ claude plugin install prompt-cache-control --marketplace Nasrallah-Adel/claude-prompt-cache-control

cache-tax

karanb192/cache-tax

148

Keeps the prompt cache warm while you take a break and shows the estimated cost before a cold send.

UIPromptCommandsModerate access
$ claude --plugin-dir ./cache-tax