Statusline

Modular status line system for Claude Code with configurable profiles and 7 display modules.

Overview

This skill provides a customizable status line that displays real-time information during Claude Code sessions.

Architecture

scripts/statusline/
├── src/
│   ├── index.ts                 # Main entry point (reads stdin HookInput)
│   ├── cli.ts                   # CLI argument parser
│   └── lib/
│       ├── types.ts             # HookInput interface, type definitions
│       ├── config-manager.ts    # Profile loading, deep merge, config resolution
│       ├── context.ts           # Standalone context token counter
│       ├── formatters.ts        # ANSI colors, progress bars, path formatting
│       ├── usage-limits.ts      # OAuth token retrieval, Anthropic API usage
│       └── modules/
│           ├── base.ts          # BaseStatusModule abstract class
│           ├── path.ts          # PathModule
│           ├── context.ts       # ContextModule (transcript parsing)
│           ├── git.ts           # GitModule (branch, changes, diff stats)
│           ├── battery.ts       # BatteryModule (pmset, macOS)
│           ├── memory.ts        # MemoryModule (vm_stat, macOS)
│           ├── usage.ts         # UsageModule (API usage bars)
│           └── cost.ts          # CostModule (session cost + duration)
├── config/
│   ├── default.json             # Default module configuration
│   └── profiles/
│       ├── minimal.json         # Path + context only
│       ├── standard.json        # Balanced with usage
│       ├── developer.json       # All modules including git + cost
│       ├── full.json            # Everything enabled
│       └── classic.json         # Block-style progress bars
├── statusline.config.ts         # Legacy config interface
├── package.json
├── tsconfig.json
└── biome.json

Installation

Step 1: Install dependencies

cd ~/.claude/plugins/marketplaces/topographic-plugins-official/plugins/dev/skills/statusline/scripts/statusline
bun install

Step 2: Configure status line in settings.json

Add or update the statusLine entry in ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "bun ~/.claude/plugins/marketplaces/topographic-plugins-official/plugins/dev/skills/statusline/scripts/statusline/src/index.ts",
    "padding": 0
  }
}

Step 3: Verify installation

Restart Claude Code. The status line should appear at the bottom of the terminal.

To test manually:

echo '{"session_id":"test","transcript_path":"/tmp/test","cwd":"/tmp","model":"claude-sonnet-4-20250514"}' | bun ~/.claude/plugins/marketplaces/topographic-plugins-official/plugins/dev/skills/statusline/scripts/statusline/src/index.ts

Profiles

Switch profiles via CLI argument or by editing config/default.json.

Using a Profile

Edit the statusLine command in settings.json to pass --profile:

{
  "statusLine": {
    "type": "command",
    "command": "bun ~/.claude/plugins/marketplaces/topographic-plugins-official/plugins/dev/skills/statusline/scripts/statusline/src/index.ts --profile developer",
    "padding": 0
  }
}

CLI Options

Customization

Editing Module Configuration

Edit config/default.json to customize individual modules:

{
  "modules": {
    "path": { "enabled": true, "mode": "full" },
    "git": { "enabled": true, "showBranch": true, "showChanges": true },
    "usage": { "enabled": true, "progressBarStyle": "braille" }
  }
}

Creating a Custom Profile

Add a JSON file in config/profiles/:

{
  "modules": {
    "path": { "enabled": true, "mode": "short" },
    "context": { "enabled": true },
    "git": { "enabled": true }
  },
  "separator": " | "
}

macOS-Specific Modules

The battery and memory modules use macOS-specific commands:

• Battery: pmset -g batt (power management)
• Memory: vm_stat (virtual memory statistics)

These modules gracefully degrade on non-macOS systems (disabled or show fallback).

Troubleshooting

Status line not appearing

1. Verify the command path in settings.json points to the correct location
2. Ensure bun is in PATH
3. Test manually with echo + pipe (see Step 3 above)
4. Check for errors: add --debug flag to the command

Usage module shows empty

The usage module requires OAuth authentication with Anthropic. It reads the token from macOS Keychain (security find-generic-password). If not authenticated, the module shows no data.

Modules not loading

Check config/default.json — modules must have "enabled": true to appear.