Home

Awesome

TaskUI - Simple Terminal UI for Task / taskfile.dev

TaskUI is a lightweight terminal user interface for executing tasks defined using taskfile.dev. It provides an easy way to navigate through tasks using arrow keys or Vim-like shortcuts.

Current features are task execution, search and preview.

taskui-example

Usage

Configuration

TaskUI can be configured using environment variables.

Available configuration options are:

Environment VariableDescriptionDefault
TASKUI_LIST_INTERNALShow internal tasks in the task listfalse
TASKUI_HIGHLIGHT_STYLE_BGBackground color for highlighted task#ffffff
TASKUI_HIGHLIGHT_STYLE_FGForeground/text color for highlighted task#4c4f69

Installation

  1. Clone the repository:
git clone https://github.com/thmshmm/taskui.git
  1. Build the binary

using cargo:

cd taskui
cargo build --release

using Nix:

nix build
  1. Create a shell alias for easy access:
alias tui="/path/to/taskui"

Example Taskfile.yml

version: '3'

includes:
  k8s: ./k8s.yml
  docker: ./docker # requires ./docker/Taskfile.yml to exits
  helm:
    taskfile: ./helm.yml
    optional: true

tasks:
  uptime:
    cmds:
      - uptime
  date:
    cmds:
      - date

Contributing

If you have any suggestions, improvements, or bug fixes, feel free to open an issue or submit a pull request.