Andre 17e09bc513 feat: print a glyph self-test at the end of install
An installer can guarantee the assets and the font are in place but not that
the terminal actually draws the glyphs - that is the one thing decided on the
target machine at display time. Emitting the exact symbol set lets the user
confirm rendering at a glance and points a failing case at the terminal choice
rather than a missing font, which is the only remaining variable.
2026-07-18 16:02:43 +02:00

English | Deutsch


English

Claude Code Statusline Kit

A portable, self-contained kit that installs a custom Claude Code statusline (built on the cship Starship fork) onto any Windows PC with a single command.

What it installs

Asset Target location Purpose
assets/cship.exe ~/.local/bin/ Renders the statusline
assets/cship.toml ~/.config/ Module config (colors, icons, bars)
assets/cship-statusline.ps1 ~/.claude/ Wrapper (progress bars, token formatting)
statusLine block ~/.claude/settings.json Wires everything into Claude Code

Requirements

  • PowerShell 7 (pwsh). Install: winget install --id Microsoft.PowerShell -e
  • An emoji-capable terminal font so 🤖 ⚡ 🧠 █░ render. No Nerd Font required — the statusline deliberately uses only standard Unicode (emoji + block-drawing chars), never Nerd-Font private-use glyphs. Windows Terminal renders them via Segoe UI Emoji out of the box. As a safety net the installer nevertheless installs a Nerd Font (Hack, ~17 MB) per-user, no admin rights if none is present — see below.

Install on a new PC

git clone <your-repo-url> Claude_Statusline
cd Claude_Statusline
.\install.ps1

Then restart Claude Code (or start a new session).

The installer is idempotent — run it again anytime. It auto-detects the pwsh path on the target machine and merges the statusLine block into an existing settings.json without overwriting your other settings (a .bak backup is written first).

Nerd Font (automatic, no admin)

If no Nerd Font is detected, the installer downloads one from ryanoasis/nerd-fonts and installs it into the per-user font store (%LOCALAPPDATA%\Microsoft\Windows\Fonts + HKCU), so no administrator rights are needed. If a download fails (e.g. no internet), the step is skipped and the statusline still works via the emoji fallback. To actually use the font, set it as your terminal font and restart the terminal — the statusline renders correctly either way.

Options

  • .\install.ps1 -Force — also overwrite an existing ~/.config/cship.toml (by default an existing config is kept, so local tweaks survive).
  • .\install.ps1 -SkipFont — skip the Nerd-Font check/install entirely.
  • .\install.ps1 -FontName FiraCode — install a different Nerd Font (default Hack; e.g. FiraCode, CascadiaCode, JetBrainsMono).

Updating the kit

Edit the files under assets/, commit, git push. On another PC:

git pull
.\install.ps1 -Force

Deutsch

Claude Code Statusline Kit

Ein portables, in sich geschlossenes Kit, das eine individuelle Claude-Code- Statusline (basierend auf dem Starship-Fork cship) mit einem einzigen Befehl auf jeden Windows-PC installiert.

Was installiert wird

Asset Zielort Zweck
assets/cship.exe ~/.local/bin/ Rendert die Statusline
assets/cship.toml ~/.config/ Modul-Konfiguration (Farben, Icons, Bars)
assets/cship-statusline.ps1 ~/.claude/ Wrapper (Progress-Bars, Token-Format)
statusLine-Block ~/.claude/settings.json Verdrahtet alles in Claude Code

Voraussetzungen

  • PowerShell 7 (pwsh). Installation: winget install --id Microsoft.PowerShell -e
  • Ein emoji-fähiger Terminal-Font, damit 🤖 ⚡ 🧠 █░ dargestellt werden. Kein Nerd-Font nötig — die Statusline nutzt bewusst nur Standard-Unicode (Emoji + Block-Zeichen), keine Nerd-Font-Privatzeichen. Windows Terminal rendert sie standardmäßig über Segoe UI Emoji. Als Sicherheitsnetz installiert der Installer dennoch einen Nerd-Font (Hack, ~17 MB) per-user, ohne Admin-Rechte, falls keiner vorhanden ist — siehe unten.

Installation auf einem neuen PC

git clone <deine-repo-url> Claude_Statusline
cd Claude_Statusline
.\install.ps1

Danach Claude Code neu starten (oder eine neue Session öffnen).

Der Installer ist idempotent — jederzeit erneut ausführbar. Er erkennt den pwsh-Pfad auf dem Zielrechner automatisch und fügt den statusLine-Block in eine vorhandene settings.json ein, ohne deine anderen Einstellungen zu überschreiben (vorher wird ein .bak-Backup geschrieben).

Nerd-Font (automatisch, ohne Admin)

Wird kein Nerd-Font erkannt, lädt der Installer einen von ryanoasis/nerd-fonts und installiert ihn in den benutzereigenen Font-Speicher (%LOCALAPPDATA%\Microsoft\Windows\Fonts

  • HKCU) — ohne Administrator-Rechte. Schlägt der Download fehl (z. B. kein Internet), wird der Schritt übersprungen und die Statusline funktioniert dank Emoji-Fallback trotzdem. Um den Font tatsächlich zu nutzen, ihn als Terminal-Font einstellen und das Terminal neu starten — die Statusline wird so oder so korrekt dargestellt.

Optionen

  • .\install.ps1 -Force — überschreibt zusätzlich eine vorhandene ~/.config/cship.toml (standardmäßig wird eine bestehende Config behalten, damit lokale Anpassungen erhalten bleiben).
  • .\install.ps1 -SkipFont — überspringt die Nerd-Font-Prüfung/-Installation.
  • .\install.ps1 -FontName FiraCode — installiert einen anderen Nerd-Font (Standard Hack; z. B. FiraCode, CascadiaCode, JetBrainsMono).

Kit aktualisieren

Dateien unter assets/ bearbeiten, committen, git push. Auf einem anderen PC:

git pull
.\install.ps1 -Force
S
Description
No description provided
Readme
1.7 MiB
Languages
PowerShell 100%