Hep.gg Documentation

Status line sync

Install and sync the Hep.gg Claude Code status line across machines with ccas, and wire it into Claude Code in one command.

Read via MCP

ccas ships its own Claude Code status line, thms-statusline, a customizable status line built on the popular ccstatusline. ccas downloads it, wires it into Claude Code, and syncs your layout across machines, so your status line looks the same everywhere.

Commands

ccas statusline pull       # download your layout (or the Hep.gg default) + install and wire it in
ccas statusline push       # upload this machine's layout to your account
ccas statusline install    # install the bundle and set it as your Claude Code status line
ccas statusline default    # install the Hep.gg default layout
ccas statusline customize  # open the interactive editor, then push to sync

Typical flow:

  1. On your first machine: ccas statusline pull. It installs the bundle, writes the layout, and sets it as the Claude Code status line in one step.
  2. Tweak it with ccas statusline customize (an interactive editor), then ccas statusline push to save it to your account.
  3. On another machine: ccas statusline pull writes your saved layout and wires it into Claude Code (no extra steps).

The first time it installs, an existing upstream ~/.config/ccstatusline layout is migrated forward automatically, so nothing is lost if you used ccstatusline before.

The Hep.gg default

If you have never run ccas statusline push, you do not have a saved layout yet. In that case ccas statusline pull falls back to the Hep.gg default status line and installs it, so a fresh machine still gets a good-looking status line in one command. You can also install it explicitly any time with ccas statusline default, even if you already have your own saved.

The default tracks the Hep.gg maintainer's current status line, so it stays up to date on its own. Once you customize your own and ccas statusline push it, pull uses yours instead of the default.

Staying current

ccas keeps the bundle fresh on its own: it self-updates hourly and on Claude Code launch (via a SessionStart hook it registers), so the latest status line code is used without you re-running anything.

Quotes

Every so often, instead of your usual widgets, the status line shows a short quote. Mostly something worth reading twice, with the odd programming joke thrown in. It sits there for a few seconds and then your normal line comes back.

It is meant to be quiet. No flashing, no colour bar, nothing moving. Just a line of soft text with a small terracotta mark, so it reads as part of working rather than as something demanding your attention. You will notice it if you look at it.

Mixed in among the quotes are occasional ccas tips, marked with a small pointer instead of a diamond. They point out things you already have and might not be using: pooling a second account, syncing your setup to a new machine, where your hours went. Roughly one line in eight is a tip.

This is on to begin with. Turn it off with Status line quotes on the AI accounts page, and it stops on every machine within a few seconds. Nothing to reinstall.

Quotes always give way. If a usage warning, an account switch, or a message from us needs the bar, it takes it immediately, even mid-quote. A quote will never delay something you actually needed to see.

Time tracking widget

The status line powers time tracking automatically, and the ccas Time Today widget shows your running total (all machines) right in the status line. Add it with ccas statusline customize.