SleepWell

Productivity toolkit for managing tasks, plans, reviews, streaks, reminders, priorities, archives, tags, timelines, reports, and weekly reviews. Each command logs timestamped entries and lets you review past entries, search history, view statistics, and export data in multiple formats.

Commands

How It Works

Each productivity command (add, plan, track, review, etc.) works in two modes:

• - With arguments: Saves the input with a timestamp to a dedicated .log file and displays the total entry count
• Without arguments: Shows the 20 most recent entries from that category's log file

All actions are also recorded in a central history.log for unified tracking.

Typical Workflow

1. 1. Plan your day: INLINECODE21
2. Track tasks: INLINECODE22
3. Set reminders: INLINECODE23
4. Prioritize: INLINECODE24
5. Review progress: INLINECODE25
6. Weekly roundup: INLINECODE26

Data Storage

All data is stored in ~/.local/share/sleepwell/. The directory contains:

• - add.log, plan.log, track.log, review.log, etc. — one log file per command category
• INLINECODE32 — central log of all actions with timestamps
• INLINECODE33, export.csv, export.txt — generated export files

The tool automatically creates the data directory on first run.

Requirements

• - Shell: Bash 4+
• No external dependencies — uses only standard Unix utilities (date, wc, du, grep, tail, head)
• Works on: Linux, macOS, any POSIX-compatible system

When to Use

1. 1. Daily task management — Use sleepwell add "fix login bug" and sleepwell track "started debugging" to log and track tasks throughout the day
2. Sprint planning — Run sleepwell plan "Sprint 14: auth refactor, API docs, deploy" to record sprint plans and reference them later
3. Building accountability streaks — Log daily wins with sleepwell streak "Day 15: shipped feature" and review your consistency over time
4. Weekly retrospectives — Use sleepwell weekly-review "Good velocity, need to reduce meeting time" for structured reflection
5. Searching past decisions — Run sleepwell search "deploy" to find all entries across every category mentioning deployments

Examples

CODEBLOCK0

Export Formats

The export command supports three formats:

• - json — Array of objects with type, time, and value fields
• csv — Comma-separated with type,time,value header
• txt — Plain text grouped by category

Export files are saved to the data directory and the output shows the file path and size in bytes.

Output

All command output goes to stdout in plain text. Use shell redirection for saving:

CODEBLOCK1