taskbook

repository·master·Indexed 27 days ago

https://github.com/klaudiosinani/taskbook

A lightweight command-line task and note management tool (v0.3.0) that organizes items into boards and timelines. It features atomic data storage, archiving capabilities, and a minimal syntax for terminal-based workflows. Users can manage tasks and notes via the `tb` CLI, utilizing flags for creating tasks, toggling statuses (complete, started, starred), and filtering items by attributes.

Tokens
9.3K
Snippets
42
Records
90
Agent score
90%

What's inside taskbook

  1. View Taskbook Boards and Timelines

    master

    Taskbook provides two primary ways to visualize your data:

    1. Board View: The default view when running tb without options. It displays all stored items grouped into their respective panels.
    2. Timeline View: Displays all items in a chronological view based on their creation date. Use the --timeline or -i flag to access this view.
  2. Manage task status, stars, and completion

    master

    Taskbook uses toggle-style flags for status management. Running the command on an item will switch its state to the opposite (e.g., marking a completed task as incomplete).

    • --check/-c: Toggle completion status (done/incomplete).
    • --begin/-b: Toggle start status (started/not started).
    • --star/-s: Toggle star status (starred/unstarred).
  3. Update task status, priority, and favorites

    master

    Taskbook allows you to toggle various item states using their IDs:

    • Complete/Incomplete: Use --check/-c to toggle the completion status.
    • Start/Pause: Use --begin/-b to toggle the 'in progress' status.
    • Favorite: Use --star/-s to toggle the starred status.
    • Priority:
      • Set priority during creation using p:x in the description (where x is 1 for normal, 2 for medium, or 3 for high).
      • Update priority using --priority/-p followed by the item ID (prefixed with @) and the new level (1, 2, or 3).
  4. Search, list, and view items

    master

    Use the following commands to navigate your data:

    • Show all items (Board View): Run tb without options to see items grouped by boards.
    • Show Timeline: Use --timeline/-i to see items ordered by creation date.
    • Search: Use --find/-f followed by search terms.
    • List with filters: Use --list/-l followed by attributes to filter results.
  5. Filter and search items

    master

    Use the --list/-l option to filter items by specific attributes, or --find/-f to search for text.

    Available attributes for --list:

    • myboard: Items in My board
    • task, tasks, todo: Items that are tasks
    • note, notes: Items that are notes
    • pending, unchecked, incomplete: Pending tasks
    • progress, started, begun: In-progress tasks
    • done, checked, complete: Completed tasks
    • star, starred: Starred items

    Search: Use --find/-f followed by the search term.

  6. View tasks in Board or Timeline view

    master

    Taskbook provides two primary ways to visualize your data:

    • Board View: The default view. Invoking tb without any options shows all items grouped by their respective boards.
    • Timeline View: Use the --timeline or -i flag to list all items in a timeline based on their creation dates.
  7. Delete and restore items

    master

    Deleted items are automatically archived and can be recovered.

    • Delete: Use --delete/-d followed by the item IDs.
    • Clear completed: Use --clear to remove all completed tasks across all boards (this option has no short alias).
    • Restore: Use --restore/-r followed by the item IDs to bring them back.
    • View Archive: Use --archive/-a to view all archived items in a timeline view.
    $ tb -d 1 2
    $ tb --clear
    $ tb -a
    $ tb -r 1 2