TimeBlocks

Time blocking scheduler. Plan your day in blocks, protect your deep work time.

Install

npx @lxgicstudios/timeblocks
# or install globally
npm install -g @lxgicstudios/timeblocks

Usage

# Start with a template
tb template              # Apply default day structure

# Or build your own day
tb add 09:00 11:00 "Deep coding" deep
tb add 11:00 11:15 "Coffee break" break
tb add 11:15 12:30 "Email & Slack" shallow

# See your day
tb                       # View today's blocks
tb now                   # What should I be doing?

# Track completion
tb done abc123           # Mark block complete

Block Types

Type	Icon	Use For
deep	🎯	Coding, writing, thinking
shallow	📧	Email, admin, quick tasks
break	☕	Breaks, lunch, rest
meeting	👥	Meetings, calls
personal	🏠	Personal time

Example Day

📅 Monday, Jan 30 (Today)

09:00-11:00 🎯 Deep Work (2h)
11:00-11:15 ☕ Break (15m)
11:15-12:30 📧 Email & Slack (1h 15m)
12:30-13:30 ☕ Lunch (1h)
13:30-15:30 🎯 Deep Work (2h)
15:30-15:45 ☕ Break (15m)
15:45-17:00 👥 Team Sync (1h 15m)

─────────────────────────────
Deep work: 4h (50%)

Stats

📊 Time Block Stats (last 7 days)

🎯 deep       ████████████░░░░░░░░ 24h 30m (52%)
📧 shallow    ██████░░░░░░░░░░░░░░ 8h 15m (18%)
👥 meeting    █████░░░░░░░░░░░░░░░ 7h 0m (15%)
☕ break      ████░░░░░░░░░░░░░░░░ 5h 30m (12%)
🏠 personal   ██░░░░░░░░░░░░░░░░░░ 1h 30m (3%)

Templates

Default template provides a balanced day. Create custom templates in ~/.timeblocks/templates.json.

---

Built by LXGIC Studios

🔗 GitHub · Twitter