Kutengeneza Mstari wa Hali (Status Line) Maalum kwa ajili ya Claude Code

Ninatumia sehemu kubwa ya siku yangu kwenye Claude Code. Inafanya kazi kama programmer na mhakiki wangu.

Baada ya siku chache, niligundua tatizo. Sikujua ni tokeni ngapi nilizotumia. Sikujua gharama ya kikao changu (session cost). Sikujua ni kiasi gani cha muktadha (context) kilichobaki.

Sitaki kuendesha amri (command) ili kuangalia ukweli huu. Nataka kuyaona kwa wakati halisi (real time). Nataka kutazama terminal yangu na kujua hali yangu.

Hivyo, nilitengeneza mstari wa hali maalum.

Nilijikita katika mambo makuu matatu:

  • Session Cost: Claude Opus si bure. Kuona gharama mubashara kunanisaidia kuamua ni lini nimalize kazi.
  • Context Window: Nataka kuona asilimia ya muktadha iliyobaki. Hii inanisaidia kuamua ni lini nianze kikao kipya.
  • Project Info: Nahitaji kuona directory yangu ya sasa, git branch, na modeli ninayotumia.

API ya mstari wa hali ni rahisi. Unaelekeza Claude Code kwenye shell script. Zana hiyo hutuma hati ya JSON kwenye script yako kupitia stdin. Script yako huchapisha matokeo kwenye stdout.

Haitumii SDK wala framework. Inatumia tu stdin na stdout. Inafanya kazi ndani ya kompyuta yako (locally) na haigharimu chochote.

Jinsi ya kuifanya kazi:

  1. Tengeneza script kwenye ~/.claude/statusline.sh.
  2. Tumia jq kuchambua data ya JSON.
  3. Panga matokeo (format output) ili kuonyesha path yako, branch, modeli, tokeni, na gharama.
  4. Ongeza script hiyo kwenye faili lako la ~/.claude/settings.json.

Unaweza kuweka muda wa kuhuisha (refresh interval) kuwa sekunde 1. Hii inakupa dashibodi ya wakati halisi.

Ikiwa hutaki kuandika kodi, Claude Code ina njia ya mkato. Endesha: /statusline show me model, branch, token counts, context percentage, and cost

Hii inatengeneza mstari kwako kiotomatiki.

Kurekebisha zana zako kwa kutumia shell scripts rahisi kunabadilisha jinsi unavyofanya kazi. Unaacha kusubiri vipengele (features) na kuanza kujenga otomatiki (automation) yako mwenyewe.

Chanzo: https://dev.to/ndrone/building-a-custom-status-line-for-claude-code-5822

Jumuiya ya kujifunza ya hiari: https://t.me/GyaanSetuAi