NOTELEAF(1) User Commands NOTELEAF(1) NAME noteleaf - manage tasks, notes, books, movies, TV shows, and saved articles from the command line SYNOPSIS noteleaf [--help] [--version] [] DESCRIPTION noteleaf is a terminal-first productivity tool written in Go. It combines task management (with time tracking), note-taking, and media queues (books, movies, TV shows, and saved articles) into a single command-line interface. The design borrows from Taskwarrior and todo.txt but extends them with features such as: - Interactive TUIs for browsing notes and tasks - Article parsing and storage - Unified commands across different domains - Time tracking with start/stop and timesheet summaries Subcommands are grouped by domain: task, note, book, movie, tv, and article. Each group has its own subcommands and options. OPTIONS --help, -h Show help for noteleaf or any subcommand. --version, -v Print the current version and exit. COMMANDS General help [command] Show help for a command or subcommand. version Print the program version. TASK COMMANDS noteleaf task add [description] Add a new task. Flags: -p, --priority Set task priority --project Set project -c, --context Set context -d, --due YYYY-MM-DD Set due date -t, --tags tag1,tag2 Add tags noteleaf task list List tasks. Flags: -i, --interactive Force interactive mode --static Print static list -a, --all Show all tasks --status Filter by status --priority Filter by priority --project Filter by project --context Filter by context noteleaf task view View task details. Flags: --format detailed|brief Output format --json Print JSON --no-metadata Hide metadata noteleaf task update Update task fields. Flags: --description --status -p, --priority --project -c, --context -d, --due YYYY-MM-DD --add-tag tag --remove-tag tag noteleaf task edit Interactive edit with status/priority toggles. Alias: e noteleaf task delete Delete task permanently. noteleaf task projects List projects. Flags: --static, --todo-txt noteleaf task tags List tags. Flags: --static noteleaf task contexts List contexts. Flags: --static, --todo-txt noteleaf task done Mark task as completed. Alias: complete noteleaf task start Start time tracking for a task. Flags: -n, --note Add note to entry noteleaf task stop Stop time tracking for a task. noteleaf task timesheet Show time tracking summary. Flags: -d, --days Number of days (default 7) -t, --task Timesheet for specific task noteleaf task recur set Set recurrence rule for a task. Flags: --rule Recurrence rule (e.g., FREQ=DAILY) --until YYYY-MM-DD Recurrence end date noteleaf task recur clear Clear recurrence rule from a task. noteleaf task recur show Show recurrence details for a task. noteleaf task depend add Add a dependency to a task. noteleaf task depend remove Remove a dependency from a task. Alias: rm noteleaf task depend list List dependencies for a task. Alias: ls noteleaf task depend blocked-by Show tasks blocked by this task. MOVIE COMMANDS noteleaf movie add [query...] Search and add a movie to the watch queue. Flags: -i, --interactive noteleaf movie list [--all|--watched|--queued] List movies by status. noteleaf movie watched Mark movie as watched. Alias: seen noteleaf movie remove Remove from queue. Alias: rm TV COMMANDS noteleaf tv add [query...] Search and add a TV show to the watch queue. Flags: -i, --interactive noteleaf tv list [--all|--queued|--watching|--watched] List TV shows by status. noteleaf tv watching Mark as currently watching. noteleaf tv watched Mark as watched. Alias: seen noteleaf tv remove Remove show from queue. Alias: rm BOOK COMMANDS noteleaf book add [query...] Search and add a book to the reading list. Flags: -i, --interactive noteleaf book list [--all|--reading|--finished|--queued] Show reading list. noteleaf book reading Mark book as currently reading. noteleaf book finished Mark book as finished. Alias: read noteleaf book remove Remove from reading list. Alias: rm noteleaf book progress Update reading progress percentage (0-100). noteleaf book update Update status (queued|reading|finished|removed). NOTE COMMANDS noteleaf note create [title] [content...] Create a note. Aliases: new Flags: -i, --interactive Open interactive editor -e, --editor Open note in editor -f, --file Create from markdown file noteleaf note list List notes (interactive TUI or static). Aliases: ls Flags: -a, --archived Include archived -s, --static Static list --tags tag1,tag2 Filter by tags noteleaf note read Display note content. Alias: view noteleaf note edit Edit note in editor. noteleaf note remove Remove note permanently. Aliases: rm, delete, del ARTICLE COMMANDS noteleaf article add Parse and save article from URL. noteleaf article list [query] List saved articles. Aliases: ls Flags: --author -l, --limit noteleaf article view Show article metadata and preview. Alias: show noteleaf article read Display full content as Markdown. noteleaf article remove Remove article and associated files. Aliases: rm, delete EXIT STATUS noteleaf returns 0 on success. Non-zero exit status indicates an error. EXAMPLES Add and list tasks: noteleaf task add "Write blog post" -p H --project blog --due 2025-10-15 noteleaf task list --project blog Mark complete: noteleaf task done 42 Track media: noteleaf book add "The Name of the Wind" noteleaf movie add "Blade Runner" -i noteleaf tv list --watching Work with notes: noteleaf note create "Ideas" "sketch out product roadmap" noteleaf note list --tags=work Save an article: noteleaf article add https://example.com/post noteleaf article list --author "Ada Lovelace" Manage task recurrence: noteleaf task recur set 42 --rule FREQ=DAILY --until 2025-12-31 noteleaf task recur show 42 noteleaf task recur clear 42 Manage task dependencies: noteleaf task depend add 42 abc123-uuid noteleaf task depend list 42 noteleaf task depend blocked-by abc123-uuid noteleaf task depend remove 42 abc123-uuid FILES (TODO: configuration and data file paths once implemented) SEE ALSO Taskwarrior(1), todo.txt(5), git(1), neovim(1), rsync(1) AUTHOR Owais @ Stormlight Labs BUGS Please report issues at: https://github.com/stormlightlabs/noteleaf/issues COPYRIGHT Copyright (c) 2025 Stormlight Labs, LLC. Licensed under the MIT License. NOTELEAF(1) User Commands NOTELEAF(1)