Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/louis-thevenet/vault-tasks

TUI Markdown Task Manager
https://github.com/louis-thevenet/vault-tasks

markdown markdown-tasks ratatui tasks tui

Last synced: 27 days ago
JSON representation

TUI Markdown Task Manager

Host: GitHub
URL: https://github.com/louis-thevenet/vault-tasks
Owner: louis-thevenet
License: mpl-2.0
Created: 2024-08-27T11:42:29.000Z (4 months ago)
Default Branch: main
Last Pushed: 2024-11-23T21:59:41.000Z (28 days ago)
Last Synced: 2024-11-23T22:23:07.575Z (28 days ago)
Topics: markdown, markdown-tasks, ratatui, tasks, tui
Language: Rust
Homepage:
Size: 14.6 MB
Stars: 9
Watchers: 1
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

awesome-ratatui - vault-tasks - TUI Markdown Task Manager. (💻 Apps / 🚀 Productivity and Utilities)

README

        # Vault-tasks

`vault-tasks` is a TUI Markdown task manager.

It will parse any Markdown file or vault and display the tasks it contains.

![Demo](./examples/demo_full.gif)

## Why

I made this tool because I wanted to integrate my task system directly inside my Second Brain.

Markdown tasks are very easy to integrate with knowledge and projects.

I also spend most of my writing time in the terminal (Helix) and do not rely on heavy external software.

## Features

- Task Parser (see [Usage](https://github.com/louis-thevenet/vault-tasks/tree/main?tab=readme-ov-file#usage))

  - Subtasks

  - Fixed and relative dates

  - special _today_ tag and regular tags

  - descriptions

  - priority

- Navigate vault

- Search through tasks (sort and filter)

- Edit tasks or open in default editor

- Time Management tab (Pomodoro & Flowtime)

## Planned Features

- A Timeline tab with a calendar and a chronological view. (I'd also like to be able to import calendar files)

## Installation

### Cargo

```

cargo install vault-tasks

```

### Nix

It will be added to nixpkgs when I have time to make a nix module. For now, add the repo to your inputs:

```nix

vault-tasks = {

  url = "github:louis-thevenet/vault-tasks";

  inputs.nixpkgs.follows = "nixpkgs";

};

```

And use the package in your configuration: `inputs.vault-tasks.packages.${pkgs.system}.default`

### Build From Source

```

git clone https://github.com/louis-thevenet/vault-tasks.git

cd vault-tasks

cargo build --release

```

## Usage

See `vault-tasks --help` for basic usage.

### Writing tasks

```md

- [ ] An example task #tag tomorrow p1

      A description

      of this task

  - [x] A subtask today @today

  - [ ] Another subtask 10/23 @today

```

| Token                                      | Meaning                                                           |

| ------------------------------------------ | ----------------------------------------------------------------- |

| `- [ ]` (`- [X]`)                          | declares a task and sets its state                                |

| `p1` (`p10`, ...)                          | sets the priority                                                 |

| `#tag`                                     | is a tag, a task can have zero or more tags                       |

| `@today` (`@tod`, `@t`)                    | is a special tag that will mark the task as part of today's tasks |

| `23/10` (`2024/23/10`)                     | sets the due date with a literal date                             |

| `today` (`tdy`)                            | sets the due date to today                                        |

| `tomorrow` (`tmr`)                         | sets the due date to tomorrow                                     |

| a day of the week (`monday` or `mon`, etc) | sets the due date to the next occurence of that day               |

| `3d` (`3m, 3w, 3y`, ...)                   | means "in 3 days" and will set the due date accordingly           |

- `@today` allows you mark a task for today while keeping a due date. It will show up with a ☀️ in `vault-tasks`.

- Relative dates are always replaced by literal dates once `vault-tasks` is run. Thanks to this, `vault-tasks` does not store any data except its config file.

- Other tokens will be part of the title of that task

- Descriptions and subtasks are declared using indents (see config file)

This is what you will see in the preview of this `README.md` in `vault-tasks`:

![](./examples/demo_readme_explorer.png)

### Default Key Map

Check the key map within the app with `?`

#### General

| Key         | Alternate Key | Action                                    |

| ----------- | ------------- | ----------------------------------------- |

| `shift-h`   | `shift-←`     | Previous tab                              |

| `shift-l`   | `shift-→`     | Next tab                                  |

| `ctrl-k`    | `ctrl-↓`      | Scroll up                                 |

| `ctrl-j`    | `ctrl-↑`      | Scroll down                               |

| `page_down` |               | Scroll one page down                      |

| `page_up`   |               | Scroll one page up                        |

| `q`         | `ctrl-c`      | Quit the application                      |

| `?`         |               | Open keybindings menu for the current tab |

#### Explorer Tab

##### Navigation

| Key | Alternate Key     | Action              |

| --- | ----------------- | ------------------- |

| `k` | `↑`, `shift-tab`  | Previous entry      |

| `j` | `↓`, `tab`        | Next entry          |

| `h` | `←`, `back_space` | Leave current entry |

| `l` | `→`,`enter`       | Enter current entry |

##### Commands

| Key | Action                                         |

| --- | ---------------------------------------------- |

| `s` | Focus search bar (`enter` or `esc` to unfocus) |

| `o` | Open selection in default editor               |

| `e` | Quickly edit selection                         |

| `r` | Reload vault                                   |

![](./examples/demo_explorer.gif)

#### Filter Tab

##### Commands

| Key       | Action                   |

| --------- | ------------------------ |

| `enter`   | Focus/Unfocus search bar |

| `Shift-s` | Change sorting mode      |

![](./examples/demo_filter.gif)

#### Time Management Tab

##### Navigation

| Key | Alternate Key | Action           |

| --- | ------------- | ---------------- |

| `k` | `↑`           | Previous setting |

| `j` | `↓`           | Next setting     |

##### Commands

| Key         | Action                             |

| ----------- | ---------------------------------- |

| `space`     | Next segment (skip current)        |

| `p`         | Pause timer                        |

| `e`         | Edit selected setting              |

| `shift-tab` | Previous time management technique |

| `tab`       | Next time management technique     |

![](./examples/demo_time.gif)

### Modes

You can start already focused on a tab by using one of the CLI commands:

```bash

vault-tasks explorer # is the default

# Or

vault-tasks filter

vault-tasks time

```

You can also output the content of a vault in standard output using

```bash

vault-tasks stdout

```

Example output:

```

vault-tasks -v ./README.md stdout

./README.md

‾‾‾‾‾‾‾‾‾‾‾

	README.md

	‾‾‾‾‾‾‾‾‾

		Vault-tasks

		‾‾‾‾‾‾‾‾‾‾‾

			Usage

			‾‾‾‾‾

				Writing tasks

				‾‾‾‾‾‾‾‾‾‾‾‾‾

					❌ An example task

					📅 2024-11-17 (tomorrow)❗1

					#tag

					A description

					of this task

						✅ A subtask

						☀️ 📅 2024-11-16 (today)

						❌ Another subtask

						☀️ 📅 2024-10-23 (3 weeks ago)

```

## Configuration

The [`config.toml`](./.config/config.toml) contains the default configuration which can be generated using `vault-tasks generate-config`.

In `$HOME/.config/vault-tasks/config.toml`, you can override the default settings, keybindings and colorscheme.

In particular, you can set a default vault path.

## Contributing

Feel free to submit issues or pull requests. Contributions are welcome!