skills.rest
zeulewan
zeulewanCOMMUNITY
Explore all skills by this author →
Website𝕏@zeulewanGitHub

custom-statusline

Configure a Claude Code status line with Nerd Font icons and git metrics.

Updated Dec 29, 2025
Search Tags:#git#shell script#usage tracking#status line#Nerd Font#token display
One-click install
npx skills add https://github.com/zeulewan/claude-code-skills --skill custom-statusline
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: custom-statusline
Source: https://github.com/zeulewan/claude-code-skills/tree/main/custom-statusline
Command: npx skills add https://github.com/zeulewan/claude-code-skills --skill custom-statusline

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual toil of configuring and maintaining a rich Claude Code status line, delivering a consistent, informative UI with minimal effort.

Core Features & Use Cases

  • Git integration: real-time clean/dirty status, branch name, and upstream tracking.
  • Usage and context: display usage metrics, token counts, and Python/Node/Docker context.
  • System insights: battery and WiFi status, plus optional project-specific details.
  • Customization and portability: hex-escaped Nerd Font icons, color thresholds, and caching to reduce API calls.

Quick Start

Create the ~/.claude/statusline.sh script with the complete setup. Make it executable with chmod +x ~/.claude/statusline.sh. Update Claude's settings to use this script for the status line. Test by running Claude Code and, if needed, echo '{}' | ~/.claude/statusline.sh for a quick dry run.

Frequently Asked Questions about custom-statusline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I display git status and branch information in my shell status line?▼

A status line with git integration shows your branch name, upstream tracking, and clean/dirty status in real time. This Skill configures that display using Nerd Font icons and hex-escaped characters, updating automatically as you work.

Can I show token usage and API metrics in Claude Code's status line?▼

Yes. This Skill integrates usage tracking and token counts into your status line with caching to reduce API calls. It displays real-time metrics alongside git status, system context, and project details.

What's the best way to add Nerd Font icons to a shell script status line?▼

Nerd Font icons integrate via hex-escaped character sequences in shell scripts with configurable colors and thresholds. This Skill provides the complete setup as a ready-to-use script with battery, WiFi, and context indicators.

Do I need macOS-specific tools to configure a status line with system information?▼

This Skill includes macOS-specific tooling for battery and WiFi status. The setup works with Claude Code and requires only a shell script placed in ~/.claude/statusline.sh, made executable with chmod +x.

How do I set up customizable color thresholds for status line metrics?▼

Color thresholds in this Skill are configurable within the shell script, letting you define when usage or system metrics change color. The script applies these thresholds to token counts, battery level, and other tracked metrics.

Can a status line show Python, Node, and Docker context alongside git information?▼

Yes. This Skill displays optional project-specific context including Python, Node, and Docker environments in your status line, combined with git status, usage metrics, and system insights in a single unified display.

Related Skills

Explore More Software Engineering Skills→
runpodrunpod
24

Ghostty Terminal Setup

Install and configure Ghostty terminal emulator with a Nerd Font on macOS.

Official
Basic
OliverOuyangOliverOuyang
1

guanyuan-monitor

Monitor Guanyuan dashboard metrics and trigger alerts on rule violations.

Community
Intermediate
andreadellacorteandreadellacorte
5

groove-admin-claude-hooks

Install and configure native shell hooks in Claude Code settings.

Community
Intermediate
MrPointerMrPointer
2

configuring-zsh

Configures and troubleshoots Zsh shell environments via startup files and plugins.

Community
Intermediate