twkb

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #typescript #llm #golang #go #linux #docker #macos #cli #security #open-source

(★ 58)

A kanban TUI for taskwarrior, written in Go

twkb Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**twkb** (short for **t**ask**w**arrior **k**an**b**an) is a kanban-style TUI for [taskwarrior](https://taskwarrior.org), written in Go with the [bubbletea framework](https://github.com/charmbracelet/bubbletea).

![twkb demo](https://raw.githubusercontent.com/DerTimonius/twkb/main/assets/demo.gif)

## Features

- Kanban view with `todo`, `doing` and `done columns`
- Quickly the projects, labels and urgency of a task
  - And also if a task is blocked or recurring
- Creation of new tasks
- Modifying existing tasks
- Block and unblock tasks
- Create recurring tasks
- Delete tasks

In development:

- [ ] Project tabs
- [ ] Complete info of a single task

## Installation

> [!NOTE]
> twkb needs [taskwarrior](https://taskwarrior.org) to be installed

Currently, the way to install **twkb** is to use `go install`:

```sh copy
go install github.com/DerTimonius/twkb@latest
```

## Usage

| **Keys**         | **View**                    | **Functionality**                                    |
| ---------------- | --------------------------- | ---------------------------------------------------- |
| `Arrows`, `hjkl` | `normal`, `block form`      | Navigation in the different columns                  |
| `Space`          | `normal`                    | Start/Stop selected task                             |
| `Enter`          | `normal`                    | Finish selected task                                 |
| `n`              | `normal`                    | Create new task, enters `create form`                |
| `m`              | `normal`                    | Modify selected task, enters prefilled `create form` |
| `d`              | `normal`                    | Delete selected task, enters `confirmation screen`   |
| `b`              | `normal`                    | Block other tasks selected task, enters `block form` |
| `u`              | `normal`                    | Unblock selected task, enters `confirmation screen`  |
| `Tab`            | `create form`               | Go to next field                                     |
| `Enter`          | `create form`, `block form` | Confirm the form / selection                         |
| `Space`          | `block form`                | Select task that should be blocked                   |
| `Esc`            | `all forms`                 | Go back to `normal` view                             |
| `y`              | `confirmation screen`       | Confirm                                              |

## Nvim

To open twkb in Neovim, I have written a small [plugin, `twkb.nvim`](https://github.com/DerTimonius/twkb.nvim)

## Contributing

Contributions are always welcome! Please open an issue or submit a pull request if you have any improvements, bug fixes, or new features to propose.

## License

twkb is licensed under the MIT License.

twkb

twkb Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

twkb

twkb Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README