pale-signal 1.0.1

A lightweight, local-first CLI tool for tracking and analyzing daily life signals

pale-signal

A CLI tool for tracking daily life signals. All data stays locally on your machine.

╔═══════════════════════════════════════════════════════════╗
║   ██████╗  █████╗ ██╗     ███████╗    ███████╗██╗ ██████╗ ║
║   ██╔══██╗██╔══██╗██║     ██╔════╝    ██╔════╝██║██╔════╝ ║
║   ██████╔╝███████║██║     █████╗█████╗███████╗██║██║  ███╗║
║   ██╔═══╝ ██╔══██║██║     ██╔══╝╚════╝╚════██║██║██║   ██║║
║   ██║     ██║  ██║███████╗███████╗    ███████║██║╚██████╔╝║
║   ╚═╝     ╚═╝  ╚═╝╚══════╝╚══════╝    ╚══════╝╚═╝ ╚═════╝ ║
╠═══════════════════════════════════════════════════════════╣
║          Track daily signals. Build awareness.            ║
╚═══════════════════════════════════════════════════════════╝

Install

pip install pale-signal

That's it. Works globally from anywhere.

Commands

pale-signal add - Log today's data

Adding data for 2026-01-14
============================================================
Sleep hours (0-24): 7.5
Focus (1-10): 8
Mood (1-10): 7
Work hours (0-24): 9
Social interaction type:
  none       - No social interaction
  online     - Online/digital only (chat, video call)
  casual     - Brief in-person (small talk, errands)
  meaningful - Quality time with friends/family
  deep       - Deep conversation or bonding
Choose (none/online/casual/meaningful/deep): meaningful

SUCCESS: Data saved for 2026-01-14

pale-signal summary - View your stats

Summary for last 30 days (30 entries)
============================================================

AVERAGES:
  Sleep:     7.1 hours
  Focus:     6.3 / 10
  Mood:      6.6 / 10
  Work:      7.9 hours
  Social:
    casual       - 8/30 days (26.7%)
    meaningful   - 12/30 days (40.0%)
    deep         - 10/30 days (33.3%)

7-DAY ROLLING AVERAGES:
  Sleep:     7.4 hours
  Focus:     6.8 / 10
  Mood:      7.1 / 10
  Work:      7.2 hours

TOP CORRELATIONS:
  sleep_hours <-> mood: +0.72 (strong positive)
  focus <-> mood: +0.58 (moderate positive)
  sleep_hours <-> work_hours: -0.45 (moderate negative)

FLAGS:
  WARNING: Low sleep (<6h): 4/30 days (13.3%)

pale-signal plot mood - Generate a plot

Mood (1-10) (Last 30 days)
┌────────────────────────────────────────────────────────────┐
│    ●                         ●     ●   ●─●     ●       ●   │
│     ─                                                      │
│                                   ─                        │
│   ─  ●   ●           ●        ─  ●                 ●    ─  │
│                                                            │
│                     ─           ─             ─            │
│  ●    ─ ─          ●  ─     ─  ●                ─     ─  ─ │
│           ─                         ─ ─   ─         ─      │
│ ─                                                 ─        │
│●       ●               ●                     ●            ●│
│                   ─                                        │
│                         ─                                  │
│            ●               ●                ─    ●   ●     │
│             ─             ─                                │
│              ●─●─●       ●           ●     ●               │
└────────────────────────────────────────────────────────────┘
  Min: 4.0  Max: 9.0  Avg: 6.6

High-resolution plot saved to: ~/.pale-signal/output/mood_plot.png
Opening plot...

What You Track

Signal	Range	Description
sleep_hours	0-24	Hours of sleep
focus	1-10	Mental clarity
mood	1-10	Emotional state
work_hours	0-24	Hours worked
social	5 types	none, online, casual, meaningful, deep

Data Storage

Everything stays local in ~/.pale-signal/:

• data.json - Your entries
• output/ - Generated plots

License

MIT