Note-Taker

---

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 <text>` |

| `list` | List all current items | `note-taker list` |

| `done` | Mark an item as completed | `note-taker done <item>` |

| `priority` | Set priority level for an item | `note-taker priority <item> <level>` |

| `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 <item> <time>` |

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

Data Storage

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

Requirements

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 | hello@bytesagain.com