Skip to main content

​
Overview

Feature flags control which information is displayed in your statusline. Each feature can be individually enabled or disabled during the interactive setup.

​
Feature Selection

Features are selected during init via an interactive checkbox prompt (prompts.ts:18-40): 
Select statusline features (scroll down for more options):
↑/↓ arrows to navigate, SPACE to toggle, ENTER to continue
Validation: At least one feature must be selected.

​
Available Features

​
Core Information Features

​
directory
feature
default:"checked"
Display: 📁 Current working directoryPrompt Label: ”📁 Working Directory”Output Example: 📁 ~/Projects/my-appDetails:
  • Abbreviates home directory with ~
  • Extracted from workspace.current_dir or cwd in Claude Code JSON
  • Fallback parser available when jq is not installed
Default: Checked (enabled by default)Source: prompts.ts:24
​
git
feature
default:"checked"
Display: 🌿 Current git branchPrompt Label: ”🌿 Git Branch”Output Example: 🌿 feature/statuslineDetails:
  • Shows current branch name
  • Only displays if in a git repository
  • Requires git to be installed
Default: Checked (enabled by default)Source: prompts.ts:25
​
model
feature
default:"checked"
Display: 🤖 Claude model name and versionPrompt Label: ”🤖 Model Name & Version”Output Example: 🤖 Sonnet 4 🏷️ v1.0.85Details:
  • Displays model.display_name from Claude Code
  • Shows model version if available
  • Also displays Claude Code version (📟) and output style (🎨)
Default: Checked (enabled by default)Source: prompts.ts:26
​
context
feature
default:"checked"
Display: 🧠 Context window remaining percentage with progress barPrompt Label: ”🧠 Context Remaining”Output Example: 🧠 Context Remaining: 83% [========--]Details:
  • Calculates from context_window.current_usage and context_window.context_window_size
  • Formula: input_tokens + cache_creation_input_tokens + cache_read_input_tokens
  • Color-coded based on remaining percentage:
    • >40%: Mint green (#158)
    • 21-40%: Peach (#215)
    • ≤20%: Coral red (#203)
  • Requires jq for calculation
Default: Checked (enabled by default)Source: prompts.ts:27 | Implementation: bash-generator.ts:162-199

​
Usage Analytics Features

​
usage
feature
default:"checked"
Display: 💵 Cost in USDPrompt Label: ”💵 Usage & Cost”Output Example: 💰 $49.00 or 💰 $49.00 ($16.55/h) with burn rateDetails:
  • Requires ccusage integration
  • Shows cumulative cost for current session
  • Automatically enables ccusageIntegration config option
Default: Checked (enabled by default)Source: prompts.ts:28
​
tokens
feature
default:"checked"
Display: 📊 Token count and consumption ratePrompt Label: ”📊 Token Statistics”Output Example: 📊 14638846 tok (279900 tpm)Details:
  • Shows total tokens consumed in session
  • Displays tokens per minute (tpm) when burn rate is enabled
  • Requires ccusage integration and jq
Default: Checked (enabled by default)Source: prompts.ts:29
​
burnrate
feature
default:"checked"
Display: ⚡ Cost per hour and tokens per minutePrompt Label: ”⚡ Burn Rate ($/hr & tokens/min)”Output Example: 💰 $49.00 ($16.55/h) 📊 14638846 tok (279900 tpm)Details:
  • Adds hourly cost rate to usage display
  • Adds tokens per minute to token display
  • Requires ccusage integration and jq
Default: Checked (enabled by default)Source: prompts.ts:30
​
session
feature
default:"unchecked"
Display: ⌛ Session reset countdown with progress barPrompt Label: ”⌛ Session Reset Time (requires ccusage)”Output Example: ⌛ 3h 7m until reset at 01:00 (37%) [===-------]Details:
  • Shows time remaining until usage limit resets
  • Displays reset time and percentage elapsed
  • Progress bar shown in detailed theme (hidden in minimal)
  • Automatically enables ccusageIntegration when selected (prompts.ts:67)
  • Requires ccusage and jq
Default: Unchecked (disabled by default)Source: prompts.ts:31

​
Feature Dependencies

​
Requirements by Feature

FeatureRequires jqRequires gitRequires ccusage
directoryNo*NoNo
gitNoYesNo
modelNo*NoNo
contextYesNoNo
usagePartialNoYes
tokensYesNoYes
burnrateYesNoYes
sessionYesNoYes
*Fallback parser available but less reliable

​
Automatic Enablement

Certain features automatically enable configuration options: 
// From prompts.ts:67
const needsCcusage = config.features.includes('session')

return {
  // ... other config
  ccusageIntegration: needsCcusage
}
Note: While only session auto-enables ccusage integration, the features usage, tokens, and burnrate also require it to function.

​
Feature Implementation

Features are conditionally compiled into the bash script by generateBashStatusline() in bash-generator.ts:9: 
const hasGit = config.features.includes('git')
const hasUsage = config.features.some(f => 
  ['usage', 'session', 'tokens', 'burnrate'].includes(f)
)
const hasDirectory = config.features.includes('directory')
const hasModel = config.features.includes('model')
const hasContext = config.features.includes('context')
Only the selected features’ code is included in the generated script, keeping it lightweight and fast.

​
Output Layout

Features are displayed in a 3-line modern layout (v1.2.2+): Line 1: Core information
  • Directory, Git, Model, Claude Code version, Output style
Line 2: Context and session
  • Context remaining, Session reset time
Line 3: Usage analytics
  • Cost (with burn rate), Token stats (with tpm)

​
Default Feature Set

As of v1.2.2+, most features are pre-selected: 
checked: true  // directory, git, model, context, usage, tokens, burnrate
checked: false // session only
This provides a comprehensive statusline out of the box while keeping the session timer opt-in.

Build docs developers (and LLMs) love

Get started for freeTalk to us