#tasks #notes #todo #task #minimal #kanban

bin+lib utd

Create and manage activities and notes offline in your terminal

4 releases

0.1.2 Mar 22, 2022
0.1.1 Mar 18, 2022
0.1.0 Mar 17, 2022

#172 in Visualization


1.5K SLoC

ugly todo

Create tasks and save notes offline from your terminal!

This is a port/readaptation of Ugly To-Do with additional features

License Status Language Crates.io
License License License



Arch Linux

paru -S utd

Not on Arch?

You need cargo, which is provided by the rust or rustup packages. Check with your package manager. Alternatively, you can get the latest stable version of rustup by running:

curl https://sh.rustup.rs -sSf | sh

From here, you can install utd by running:

cargo install utd

Building from source

git clone https://github.com/kawaki-san/utd-rs.git && cd utd-rs

Then you can build the binary:

cargo build --release

When that's done, you can find the utd binary in the target/release directory. You may want to copy it to a directory in your $PATH. A man file is output at target/utd.1 after building should you want an entry in mandb

Start with shell


echo "utd" >> ~/.bashrc


echo "utd" >> ~/.zshrc


function fish_greeting
funcsave fish_greeting


Add task(s) with priorities:

utd -a "My first task" "My second task" "Check issues @Git" -n "Update license" -p low -p low -p high

This adds 3 tasks with custom priorities to your board (default priority is normal).

Priorities are mapped respectively to their tasks and notes - with tasks taking precedence i.e - If you set 3 tasks and 2 notes; then you pass 4 priorities - the tasks will take the first 3 priorities, the first note will have a custom priority, but the last one will use the default - normal

Run utd -h or man utd for help.


utd doesn't create a config file for you, but it looks for one in the following locations:

  • $XDG_CONFIG_HOME/utd.toml
  • $XDG_CONFIG_HOME/utd/config.toml


  • %APPDATA%\Roaming\utd\utd.toml
  • %APPDATA%\Roaming\utd\utd\config.toml

The default configuration file can be found in the repo, here


~168K SLoC