--- version: "2.0.0" name: note-taker description: "笔记整理助手。康奈尔笔记法、卡片盒笔记(Zettelkasten)、思维导图笔记、会议笔记、课堂笔记、笔记整理。Note-taking with Cornell method, Zettelkasten, mind maps, meeting notes, lecture notes." author: BytesAgain homepage: https://bytesagain.com source: https://github.com/bytesagain/ai-skills ---

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

| Command | Description | Usage | |---------|-------------|-------| | add | Add a new item to your task list | note-taker add | | list | List all current items | note-taker list | | done | Mark an item as completed | note-taker done | | priority | Set priority level for an item | note-taker priority | | clear | Clear all completed items from the list | note-taker clear |

Views & Planning

| Command | Description | Usage | |---------|-------------|-------| | today | Show today's items and schedule | note-taker today | | week | Show the weekly overview | note-taker week | | remind | Set a reminder for an item | note-taker remind |

Data & Management

| Command | Description | Usage | |---------|-------------|-------| | stats | Show total item count and statistics | note-taker stats | | export | Export all data to stdout | note-taker export | | help | Show the built-in help message | note-taker help | | version | Print the current version (v2.0.0) | note-taker version |

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
• 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

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

# Add a new task
note-taker add "Review pull request for auth module"

# Add another task
note-taker add "Prepare slides for Friday meeting"

# List all tasks
note-taker list

# Mark a task as done
note-taker done "Review pull request for auth module"

# Set priority on a task
note-taker priority "Prepare slides for Friday meeting" high

# See what's on for today
note-taker today

# Set a reminder
note-taker remind "Submit expense report" "Friday 5pm"

# View statistics
note-taker stats

# Export all data for backup
note-taker export > backup.txt

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

| Variable | Description | Default | |----------|-------------|---------| | NOTE_TAKER_DIR | Override the data directory path | ~/.local/share/note-taker | | XDG_DATA_HOME | XDG base directory (used if NOTE_TAKER_DIR is not set) | ~/.local/share |

---

Powered by BytesAgain | bytesagain.com | [email protected]