Preset Shortcuts

Preset shortcuts let you define your entire widget layout using a compact single-character notation. Set the "preset" field in your configuration file to use this feature.

How It Works

Each character maps to a specific widget. Use | to separate lines. Unknown characters are silently ignored.

{
  "preset": "MC$R|BDO"
}

This creates a 2-line layout:

• Line 1: model, context, cost, rateLimit5h
• Line 2: burnRate, sessionDuration, todoProgress

Character Mapping

Char	Widget	Char	Widget
M	model	T	toolActivity
C	context	A	agentStatus
$	cost	O	todoProgress
R	rateLimit5h	B	burnRate
7	rateLimit7d	E	depletionTime
S	rateLimit7dSonnet	H	cacheHit
P	projectInfo	X	codexUsage
I	sessionId	G	geminiUsage
D	sessionDuration	Z	zaiUsage
K	configCounts	N	tokenBreakdown
F	performance	W	forecast
U	budget

Examples

Compact with rate limits

{ "preset": "MC$R7S" }

Result: model, context, cost, rateLimit5h, rateLimit7d, rateLimit7dSonnet — all on one line.

Two-line with analytics

{ "preset": "MC$R|BDEO" }

• Line 1: model, context, cost, rateLimit5h
• Line 2: burnRate, sessionDuration, depletionTime, todoProgress

Full monitoring

{ "preset": "MC$R7|PIDBO|KTAHF|NWU|XG" }

• Line 1: model, context, cost, rateLimit5h, rateLimit7d
• Line 2: projectInfo, sessionId, sessionDuration, burnRate, todoProgress
• Line 3: configCounts, toolActivity, agentStatus, cacheHit, performance
• Line 4: tokenBreakdown, forecast, budget
• Line 5: codexUsage, geminiUsage

Combining with Other Options

The preset shorthand can be combined with theme, separator, and other configuration options:

{
  "preset": "MC$R|BDO",
  "theme": "tokyoNight",
  "separator": "dot",
  "plan": "max",
  "language": "auto",
  "cache": {
    "ttlSeconds": 300
  }
}

When preset is set, it overrides the displayMode with custom and generates the lines array automatically.