Taskbook logo

Taskbook

Tasks, boards and notes for the command-line habitat

Manage tasks and notes across multiple boards directly from your terminal with a simple syntax, atomic storage, and automatic archiving.

Taskbook banner

Overview

Command-Line Task Management

Taskbook brings lightweight project and task management to the terminal with a minimal learning curve. Designed for developers and power users who prefer keyboard-driven workflows, it enables you to organize tasks and notes across custom boards without leaving the command line.

Core Capabilities

Create tasks and notes, assign them to multiple boards using @board syntax, and track progress with priority levels, favorites, and completion status. All data is written atomically to prevent corruption and stored locally in JSON format—nothing is shared externally. Deleted items are automatically archived and can be restored at any time.

Deployment & Workflow

Install globally via npm, Yarn, or Snapcraft and configure through ~/.taskbook.json to customize storage location and display preferences. Switch between board and timeline views, search and filter items by attributes, and receive update notifications. The simple command syntax (tb -t, tb -n, tb -c) keeps friction low while board-based organization scales with your projects.

Highlights

Organize tasks and notes across multiple custom boards with `@board` tagging
Atomic writes to local JSON storage with automatic archiving of deleted items
Board and timeline views with priority, favorite, and progress tracking
Minimal syntax with search, filter, restore, and clipboard copy capabilities

Pros

  • Lightweight and fast with no external dependencies or cloud services
  • Simple, flat learning curve with intuitive command-line syntax
  • Automatic archiving prevents accidental data loss and enables restore
  • Configurable storage location and display options via JSON config

Considerations

  • Terminal-only interface may not suit users preferring graphical tools
  • No built-in collaboration or multi-user features
  • JSON file storage limits scalability for very large task sets
  • Snap installation uses non-standard storage paths due to confinement

Managed products teams compare with

When teams consider Taskbook, these hosted platforms usually appear on the same shortlist.

Any.do logo

Any.do

To-do list and task management app for organizing personal tasks, reminders, and schedules

Google Tasks logo

Google Tasks

Simple task & to-do lists integrated with Gmail and Google Calendar

Todoist logo

Todoist

Task & to-do manager with projects, labels, reminders, and AI assist

Looking for a hosted option? These are the services engineering teams benchmark against before choosing open source.

Fit guide

Great for

  • Developers and sysadmins who live in the terminal
  • Solo users managing personal projects and notes locally
  • Teams seeking simple, offline task tracking without cloud dependencies
  • Users who value data privacy and atomic storage guarantees

Not ideal when

  • Teams requiring real-time collaboration or shared task boards
  • Users who prefer graphical interfaces or mobile access
  • Projects needing advanced features like time tracking or integrations
  • Organizations with compliance requirements for centralized data storage

How teams use it

Organizing development sprints by feature area

Developers create `@frontend`, `@backend`, and `@docs` boards to track tasks, check off completed work, and view progress overviews without leaving the terminal.

Capturing technical notes during research

Engineers use `tb -n` to quickly log algorithm complexities, API endpoints, and troubleshooting steps, then search and filter notes later with `tb -f`.

Managing personal to-do lists across contexts

Users create boards like `@work`, `@home`, and `@learning` to separate tasks, star high-priority items, and archive completed tasks for future reference.

Tracking code review and documentation tasks

Teams assign tasks to `@reviews` and `@coding` boards, mark items as started with `tb -b`, and copy descriptions to clipboard for commit messages or PR comments.

Tech snapshot

JavaScript100%

Tags

boardtodotasknotecli

Frequently asked questions

Where is my data stored?

Data is stored locally in a JSON file at `~/.taskbook/storage` by default. You can customize the storage location via the `taskbookDirectory` option in `~/.taskbook.json`. Snap installations use `$SNAP_USER_DATA` instead of `$HOME`.

Can I recover deleted tasks or notes?

Yes. Deleted items are automatically archived and can be viewed with `tb --archive` or restored using `tb --restore <id>`.

How do I assign a task to multiple boards?

Include board names prefixed with `@` in the task description, e.g., `tb -t @coding @docs Update README`. The task will appear on both boards.

Does taskbook sync across devices?

No built-in sync exists. However, you can configure `taskbookDirectory` to point to a cloud-synced folder (Dropbox, Google Drive, etc.) to manually sync the JSON storage file.

What happens if two processes write simultaneously?

Taskbook uses atomic writes to prevent corruption. However, concurrent writes from multiple terminal sessions may result in one overwriting the other; manual conflict resolution would be required.

Project at a glance

Active
Stars
9,250
Watchers
9,250
Forks
392
LicenseMIT
Repo age7 years old
Last commit3 months ago
Primary languageJavaScript

Last synced 4 hours ago