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 INLINECODE37
• 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, INLINECODE44

When to Use

1. 1. Daily task tracking — use add to capture tasks throughout the day, today to see what's on your plate, and done to check off completed work
2. Weekly planning sessions — use week for an overview, priority to rank what matters most, and remind for upcoming deadlines
3. Quick capture from terminal — when you're already in the terminal and want to jot something down without switching apps, add is instant
4. Reviewing progress — use list to see everything, stats for totals, and export to pipe data into other tools for analysis
5. Maintaining a clean list — use clear to remove completed items and keep your active list focused on what still needs attention

Examples

CODEBLOCK0

Output

Commands print concise confirmations to stdout. list and export output the full data file. stats shows a total count. All actions are also logged to history.log for auditing. Redirect output with standard shell operators: note-taker list > tasks.txt.

Configuration