Installation

The goal is to install once, then run taskdb ... directly from your shell.

Option A (recommended): install the release binary

curl -fsSL https://raw.githubusercontent.com/toastdriven/taskdb/main/scripts/install.sh | bash

This installs taskdb to /usr/local/bin by default (or $INSTALL_DIR if set).

Option B: global install with Bun

Requires Bun:

# install Bun (if needed)
curl -fsSL https://bun.sh/install | bash

# install taskdb globally
bun add -g taskdb

Verify installation

taskdb --help
# or
taskdb --version

Initialize a project

Run once inside the project you want to track:

taskdb init

This creates the .tasks/ directory structure.

Tip: override the project path with --project=<path> or TASKDB_PROJECT_PATH.