tasu 0.6.0

A terminal todo list that ages
Documentation

tasu

Crates.io CI License

A terminal todo list that ages.

Tasks you record go into today. Whatever you don't finish sinks — today's leftovers become this week's, and this week's leftovers become later. There are no due dates, projects or tags; the list organizes itself by how fresh each task is.

TODAY
──────────────────────────────────────
 ○ Nand2Tetris chapter 6
 ○ learn GPUI events
 THIS WEEK  41/53
──────────────────────────────────────
 ○ write the README
 LATER
──────────────────────────────────────
 ○ read the ratatui source

Install

Prebuilt binaries, no Rust needed.

macOS / Linux

brew install mancuoj/tap/tasu

or:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mancuoj-collective/tasu/releases/latest/download/tasu-installer.sh | sh

Windows (x86_64) — in PowerShell:

powershell -ExecutionPolicy Bypass -c "irm https://github.com/mancuoj-collective/tasu/releases/latest/download/tasu-installer.ps1 | iex"

This puts tasu.exe in %USERPROFILE%\.cargo\bin and adds it to your PATH; open a new terminal afterwards. Or download tasu-x86_64-pc-windows-msvc.zip and put tasu.exe on your PATH.

With Cargo

cargo install tasu

Or from source:

git clone https://github.com/mancuoj-collective/tasu.git
cd tasu
cargo install --path .

Requires Rust 1.88 or newer.

Usage

tasu                 # open the app
tasu add "buy cat food"   # record a task without opening the app
tasu config          # show the resolved data dir, config file and sync remote
tasu remote <url>    # set the git sync remote (see below)
tasu sync            # run one pull-then-push now and print the result
Key Action
q / Esc quit
Ctrl+c quit from anywhere
j / k / ↑ / ↓ move the cursor
h / l / ← / → jump to the previous / next bucket
g / G go to the top / bottom
space / Enter complete
a add (goes into today)
e edit the title
t move to today
[ / ] send the task to a nearer / farther bucket
x drop (archive)
c open history — Tab or ←/→ switches between done and dropped
? help

Narrow terminals stack the buckets vertically; terminals 100 columns or wider lay them out as three side-by-side columns.

Completing or dropping a task moves it to the history overlay (c), where either can be restored to its original bucket with Enter, or filtered by typing in the search box.

Configuration

tasu is zero-config by default and purely local unless you point it at a git remote. Both settings can be given as environment variables or in a small config file.

Setting Default Environment Config file
Data directory platform data dir /tasu TASU_DATA data_dir
Sync remote none (local only) TASU_REMOTE remote

The config file lives at the platform config directory, in tasu/config.json:

{
  "data_dir": "/path/to/tasu-data",
  "remote": "git@github.com:you/tasu-data.git"
}

Environment variables take precedence over the file. With no remote, tasu never invokes git.

Syncing between machines (optional)

Sync is plain git against a single repository, so a private repo, a Gist or a self-hosted server all work the same. Create a private repository and point tasu at it:

tasu remote you/tasu-data      # GitHub shorthand → https://github.com/you/tasu-data.git
tasu                            # next start clones/syncs

tasu remote accepts a full URL, an SSH address (git@…), a local path, or a GitHub owner/repo shorthand. It checks that the remote is reachable and that credentials work before saving it; over HTTPS this uses the token your git credential helper already stores. If the check fails, the remote is not saved (and cleared if it was set before), so tasu never gets stuck retrying an unreachable repo — it prints the real git error and how to fix it.

The repository does not have to be empty: if it already has commits (say a README), tasu adopts that history on first sync and pushes the local board on top, keeping both.

If the remote also already has a board, the first connection merges the two: tasks are unioned and exact duplicates dropped, so neither machine's tasks are lost. Later syncs are back to plain single-writer pull/push.

The sync branch

All machines sync on one branch, so a Windows box whose git defaults to master cannot split your data across two branches. When the remote already has a default branch, tasu adopts its name (and renames the local branch to match); otherwise it uses main. A machine's init.defaultBranch setting never reaches the data repository.

tasu remote with no argument prints the current remote, and tasu remote --clear turns syncing off. The data directory and sync remote are also shown at the bottom of the in-app help (?).

On the first run tasu initializes the data directory as a git repository and pushes. On another machine, an empty data directory is cloned from the remote.

How it behaves inside the app:

  • pulls when it starts;
  • after each change, commits and pushes a few seconds later (debounced);
  • shows a blinking dot in the footer while a sync is running, and ✗ sync failed · <reason> if the last one failed;
  • shows the same one-line reason in the help overlay; run tasu sync for the full git error;
  • pushes once more on exit;
  • if the network is down or the push fails, stays quiet and retries later (pulling first, so a rejected push can recover).

If syncing seems stuck, tasu sync runs it once and prints the real git error, and tasu config shows which remote is in use.

tasu add pulls before it reads and pushes after it writes, so a machine that only ever uses the CLI stays in sync too.

This is designed for a single writer at a time (your work machine and your home machine, not both at once). There is no merge of conflicting edits; the last write wins.

Trying sync locally

You can validate the whole thing against a local bare repository:

# a stand-in for the remote
git init --bare /tmp/tasu-remote.git

# machine A
TASU_DATA=/tmp/tasu-a TASU_REMOTE=/tmp/tasu-remote.git tasu add "from A"

# machine B: clones A's history, then adds
TASU_DATA=/tmp/tasu-b TASU_REMOTE=/tmp/tasu-remote.git tasu add "from B"

# back on A: pulls B's change, then adds
TASU_DATA=/tmp/tasu-a TASU_REMOTE=/tmp/tasu-remote.git tasu add "back on A"

git --git-dir /tmp/tasu-remote.git log --oneline   # three sync commits

Non-goals

On purpose, there is no: due dates, projects, tags, priorities, subtasks, notes, notifications, recurrence, global hotkey, or multi-writer merge.

Development

The pure layers (domain, update, store, sync) are covered by unit and end-to-end tests, including a real git round trip:

cargo test
cargo clippy --all-targets --all-features -- -D warnings

To eyeball the layout without a terminal UI, render sample boards to text:

cargo run --example preview

License

Licensed under the Apache License, Version 2.0. See LICENSE.