#directory #minimalist #toml #list #task #file #completed

bin+lib tutel

a minimalistic todo app for terminal enthusiasts

6 releases

0.2.10 Mar 26, 2023
0.2.9 Nov 10, 2022
0.2.7 Aug 21, 2022

#2559 in Command line utilities

Download history 6/week @ 2024-02-25 78/week @ 2024-03-31

78 downloads per month

MIT license

31KB
809 lines

tutel

a minimalistic todo app trying to integrate with your existing workflow.

What is this?

tutel is built upon a simple principle: One Todo-List per directory.
Why? Because you (probably) already have some kind of directory based organization, so there really is no need for your todo app to redo it.
Run it and tutel will either use the todo list(saved in a .tutel.toml file) from your current directory or search upwards until one is found.

Feature Rundown

  • Walk up the current path to find todos of parent directories
  • Add Todos
  • Edit existing Todos
  • Remove Todos
  • Remove all completed todos
  • Consistent Indices of Todos across removals
  • Due dates
  • Shell completions

Installation

Using cargo

cargo install tutel

Arch Linux

There's an AUR package.

Gentoo

My overlay contains an ebuild.

Everything else

A Linux-binary is provided in the Release-Tab.

Usage

// Create a list within the current directory
tutel new

// Add a todo to the list
tutel add really important thing // Everything after the subcommand is merged, no quotes necessary

// Print the todo list
tutel

Output:
[X] list with important things
001[X]really important thing

// Mark the task as being completed
tutel done 0

// Edit the task, launches $EDITOR
tutel edit 0

// Remove it
tutel rm 0

// Or remove everything already completed
tutel rm --cleanup

What are all those symbols in my todo list?

 ┌─ sums up if the whole list is completed or not
 │    ┌─ how many recursive steps were taken to reach this
 ▼    ▼
[X] [-1] project name 
001[X]description
  ▲    ▲
  │    └─ the completion state of this task
  └─ the index of the task, used for referencing it in commands

Why the name?

This 🐢

Dependencies

~3–13MB
~134K SLoC