GitHub - tuananh131001/zccinfo: A Fast Zig CLI tool that displays Claude Code information

Overview

A blazing-fast alternative to JavaScript/Bun-based Claude Code status line tools. Written in Zig for minimal startup time and zero runtime dependencies.

Installation

Quick Install (Recommended)

1. Install the latest release with a single command:

curl -sSL https://raw.githubusercontent.com/tuananh131001/zccinfo/main/install.sh | sh

2. Add to your Claude Code settings (~/.claude/settings.json):

{
  "statusLine": {
    "type": "command",
    "command": "~/.local/bin/zccinfo"
  }
}

Restart Claude Code and you'll see Ctx: XX% in the status line when switching between modes.

Note:

To install to a custom location:

INSTALL_DIR=/usr/local/bin curl -sSL https://raw.githubusercontent.com/tuananh131001/zccinfo/main/install.sh | sh

Manual Download

Download the appropriate binary from GitHub Releases

Build from Source

Prerequisites: Zig 0.15.2 or later

# Clone the repository
git clone https://github.com/tuananh131001/zccinfo.git
cd zccinfo

# Build the project
zig build

# The binary is at zig-out/bin/zccinfo

# Or build optimized release binaries for all platforms
zig build release

NixOS / Nix

For NixOS/Home Manager flake configs, add the overlay:

{
  inputs.zccinfo.url = "github:tuananh131001/zccinfo";

  # In your nixosConfiguration or homeManagerConfiguration:
  nixpkgs.overlays = [ zccinfo.overlays.default ];
  # Then add to packages:
  environment.systemPackages = [ pkgs.zccinfo ];
}

Add to your Claude Code settings (~/.claude/settings.json):

{
  "statusLine": {
    "type": "command",
    "command": "zccinfo"
  }
}

Roadmap

• Config system (TOML)
• Auto-wrap
• Windows support
• Cost/token tracking
• Catppuccin theme & TokyoNight theme
• Multiline support
• More...

Development and Misc

For development with nix develop or direnv allow, see development guide.

See detailed benchmark results for startup time, JSONL parsing, git branch detection, and binary size comparisons.