KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #cli #claude-code #mcp #rust #deepseek-harness #ai-agent

twkb

★ 58 Open GitHub ↗

A kanban TUI for taskwarrior, written in Go

// 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

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README