Day-to-day

How to use
your desk monitor.

The dashboard explained, what to expect in standby, where to find settings, what each of the four alerts means, and how themes follow your local daylight.

Dashboard

What each number means.

The default screen is three stacked cards plus a single ambient strip. Designed to be read from 2–3 m away in under a second.

  1. 1

    Current — 5-h session window

    How much of your active 5-hour Claude / Codex / Gemini quota you've burned. Right-side projection is the AI's own forecast for end of window.

  2. 2

    Weekly — monthly cap pace

    Percent of the monthly limit consumed, with the day-of-month projection to the right. Yellow when you're trending over.

  3. 3

    Design — week's average

    Optional smaller card. Tracks long-running threads (Claude's "Design" mode). Hidden when zero so it never adds noise.

  4. 4

    Ambient strip

    Sunrise · sunset · temperature · battery. Lives under the header, stays lit in standby. Polls Open-Meteo hourly.

  5. 5

    Last-sync indicator

    The status word at the bottom (Whispering · Generating · Synthesizing) animates only while the broker has fresh data. Stale > 60 s → fades to dim.

Standby

Quiet after 20 minutes.

Backlight ramps to 0% after 20 min of no touch. The last values persist in framebuffer along with the ambient strip — at 0% backlight they're invisible but the panel doesn't blank.

Tap anywhere to wake. The dashboard fades back in over 600 ms.

Why so long? 20 min is empirically about one focused work block. Shorter and the device blanks mid-task; longer and you stop noticing it. Both bounds are tweakable in Settings.

Settings

Tap the gear, bottom-right.

The gear icon on the dashboard's footer band opens Settings. Fields are grouped into five sections so the list scans at a glance instead of becoming one long flat enumeration.

Providers

  • Claude Code · Codex · Gemini (toggle each on / off)

Display

  • Auto-rotate (Enabled / Disabled)
  • Rotate interval (10..300 s)
  • Theme (Day / Night / Auto)
  • Day brightness · Night brightness

Network

  • City (controls weather + Auto-theme sunrise / sunset)
  • Wi-Fi SSID + password
  • Broker URL (override the auto-discovered one)
  • Passphrase (rotates PSK — broker side updates via skill)

Audio

  • Alert volume (0..100%) with four test buttons for live preview

About

  • Device ID · Firmware version · IP address · Broker URL (read-only diagnostics)

Edits land on the editor screen with a slider + pencil for exact input. Cancel restores the previous value. The About rows are not editable — they show live device state for troubleshooting.

Settings list
Editor

Alerts

Four events. Hysteresis-armed.

The device fires four kinds of alert. Each is armed with a hysteresis band so it can't oscillate at the boundary — you get a single beep + flash, not a chatter loop.

Battery low

< 20%

Battery icon turns warning-orange. Soft chime on the hour.

icon · orangechime · soft

Battery critical

< 10%

Wakes the device from standby. Repeating beep until USB power is reconnected.

full wakebeep · repeat

Limit overshoot

→ > 100%

Predicted to exceed the session or weekly cap before reset. Card outline pulses gold; one chime.

card · pulsechime · once

5-h window rollover

@ rollover

Marks the moment Claude's 5-hour session window resets. Subtle bell.

flash · purplebell · soft

Themes

Day · Night · Auto.

Three modes. Auto follows sunrise/sunset for your configured city — with a ±90 s hysteresis so a passing cloud doesn't trigger a swap. Switch any time from Claude Code, Codex or Gemini:

> /cwallmonitor:theme day|night|auto
Day

High-contrast, cream paper

Night

Warm dark, low-glare

Auto

Tracks local daylight

Day · Claude Code
Night · Claude Code

Control plane

Two skills do the heavy lifting.

/cwallmonitor:configure pairs and provisions. /cwallmonitor:theme switches themes. Both ship with every CLI plugin.

Skills reference →