tb

Add a new task to a board

$ tb --task [task_description] @[board_name]

$ tb --note [note_description] @[board_name]

$ tb --priority @[item_id] [priority]

$ tb --check [item_id]

$ tb --clear

$ tb --move @[item_id] [board_name]

tb [options] [command] [arguments]

-h, --help
    Displays help information for tb or a specific command.

-v, --version
    Outputs the current version of tb.

--init
    Initializes a new tb data file if it doesn't exist. Useful for first-time setup.

--clear
    Clears all tasks and notes. Use with caution, as this action is irreversible.

add
    Adds a new task (prefixed with -t or --task) or note (prefixed with -n or --note).
Example: tb add -t "Buy groceries" or tb add -n "Meeting notes".

list [filters]
    Lists all active tasks and notes. Can be filtered by various criteria like board, priority, or type.
Example: tb list @work or tb list --priority 1.

check [id...]
    Checks off or unchecks tasks by their numerical ID. Toggles completion status.
Example: tb check 1 3.

bookmark [id...]
    Bookmarks or unbookmarks tasks/notes by their ID. Toggles bookmark status.
Example: tb bookmark 2.

delete [id...]
    Deletes tasks or notes by their numerical ID. This action is irreversible.
Example: tb delete 4.

move [id...]
    Moves specified tasks/notes to a different board. Creates the board if it doesn't exist.
Example: tb move 1 2 @home.

priority [id...]
    Sets the priority level for tasks/notes (0: none, 1: low, 2: medium, 3: high).
Example: tb priority 5 3.

archive
    Archives all completed tasks. Archived items are hidden from the default list view.

restore [id...]
    Restores archived tasks by their ID, moving them back to active.
Example: tb restore 7.

boards
    Lists all available boards and the number of items in each.

find
    Searches for tasks or notes containing the specified query string.

edit
    Opens a task or note in the default text editor for modification.

Taskbook (tb) is a free and open-source command-line utility designed for efficient management of tasks, todos, and notes. Written in Node.js, it offers a minimalistic yet powerful interface for organizing your daily activities. Users can create, check off, prioritize, and delete tasks, as well as create and manage notes. It supports organizing items into boards, making it suitable for personal project management. All data is stored in a simple JSON file, ensuring portability and ease of backup. Its intuitive syntax and quick response time make it an excellent tool for developers and power users who prefer to stay within the terminal environment for productivity.

Taskbook (tb) is not a standard pre-installed Linux command. It requires Node.js and must be installed separately, typically via npm (npm install --global taskbook).

Data is stored in a single JSON file (~/.taskbook/storage/storage.json by default), which is great for portability but not ideal for multi-user or highly concurrent environments.

Its simple design means it lacks advanced features found in more comprehensive project management tools like calendar integration or sophisticated reporting.

To install Taskbook, Node.js and npm must be pre-installed on your system. Then, run the following command in your terminal: npm install --global taskbook.
After successful installation, the tb command becomes available in your shell.

Taskbook can be configured via a JSON file typically located at ~/.taskbook/config.json. This allows customization of colors, symbols used for different item types (tasks, notes, priorities, boards), default board, and the storage file location. For example, you can set your preferred text editor for the edit command.

By default, Taskbook stores all your tasks and notes in a single JSON file: ~/.taskbook/storage/storage.json. This file is human-readable and can be easily backed up or manually edited (though not recommended while tb is running). The location of this storage file can be customized in the configuration file if desired.

Taskbook (tb) was created by Klauss Fray and first released in 2018. It quickly gained popularity in the developer community for its elegant command-line interface and minimalist approach to task management. Developed in Node.js, it leverages the widespread availability of npm for easy installation across various operating systems. Its open-source nature has allowed for community contributions and steady development, focusing on stability and user-friendly features, establishing itself as a go-to terminal productivity tool.

todo.txt-cli, task(1)