Note-Taker

A productivity and task management tool. Add items, manage a to-do list, set priorities, track daily and weekly views, set reminders, view statistics, clear completed tasks, and export data — all from the command line with persistent local storage.

Commands

Task Management

Views & Planning

Data & Management

How It Works

• add appends a date-stamped line to the data file and confirms with "Added: ..."
• list prints all items from the data file, or "(empty)" if nothing exists yet
• done marks a given item as completed and logs the action
• priority assigns a priority level (default: medium) to the specified item
• today filters the data file for today's date and displays matching items
• week shows a weekly overview of scheduled items
• remind sets a reminder for an item at a specified time (default: tomorrow)
• stats prints the total line count from the data file
• clear removes completed items from the active list
• export dumps the entire data file contents to stdout

Data Storage

All data is stored locally in ~/.local/share/note-taker/:

• data.log — the main data file containing all items (one per line, date-prefixed)
• history.log — tracks all command activity with timestamps
• Entries in data.log are formatted as YYYY-MM-DD <content>
• Set NOTE_TAKER_DIR environment variable to change the data directory
• Also respects XDG_DATA_HOME if set (defaults to ~/.local/share)

Requirements

• Bash (any modern version)
• No external dependencies — pure shell script
• Works on Linux and macOS
• Standard Unix utilities: date, wc, grep, cat

When to Use