Hackage :: [Package]

tui-launcher: Small Brick-based terminal launcher

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

tui-launcher is a small terminal launcher built with brick. . It reads a TOML config file, shows entries as a keyboard- and mouse-driven tile menu, and replaces itself with the selected command. . Features include: . * TOML configuration with auto-created default config * Per-entry working-dir, shell-program, shell-login, and color * Arrow-key and hjkl navigation * Mouse selection and scrolling * Configurable tile width, height, and spacing

[Skip to Readme]

Properties

Versions 0.0.1, 0.0.1
Change log CHANGELOG.md
Dependencies base (>=4.21 && <5), brick (>=2.10 && <2.11), containers (>=0.7 && <0.8), directory (>=1.3 && <1.4), filepath (>=1.5 && <1.6), optparse-applicative (>=0.19 && <0.20), process (>=1.6 && <1.7), text (>=2.1 && <2.2), tomland (>=1.3 && <1.4), unix (>=2.8 && <2.10), vty (>=6.5 && <6.6), vty-crossplatform (>=0.5 && <0.6) [details]
License MIT
Copyright 2026 tritlo
Author tritlo
Maintainer tritlo
Category Console
Home page https://github.com/TharkunAB/tui-launcher
Bug tracker https://github.com/TharkunAB/tui-launcher/issues
Source repo head: git clone https://github.com/TharkunAB/tui-launcher.git
Uploaded by tritlo at 2026-03-17T14:20:50Z

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Readme for tui-launcher-0.0.1

[back to package description]

tui-launcher

Hackage

Small Brick-based terminal launcher for shell commands. It reads a TOML config, shows a keyboard-driven tile menu, and replaces itself with the selected command.

Screenshots

Both dark and light terminal styles are shown in square and vertical layouts.

Dark square screenshot

Dark vertical screenshot

Light square screenshot

Light vertical screenshot

Installation

Install from Hackage:

cabal install tui-launcher

Or download the latest release binary from GitHub Releases and put it on your PATH:

curl -Lo tui-launcher \
  https://github.com/TharkunAB/tui-launcher/releases/latest/download/tui-launcher-linux-x86_64
chmod +x tui-launcher
install -Dm755 tui-launcher ~/.local/bin/tui-launcher

Then run:

tui-launcher

On first launch, tui-launcher creates ~/.config/tui-launcher/config.toml if it does not already exist.

Features

Configuration

Use the default config path:

tui-launcher

Or point at an explicit file:

tui-launcher --config /path/to/config.toml

Example config:

[layout]
tile-width = 20
tile-height = 5
tile-spacing = 1

# [shell]
# program = "/bin/bash"
# login = false

[[entries]]
name = "Shell"
command = "exec \"${SHELL:-/bin/sh}\""
color = "bright-blue"

[[entries]]
name = "nvim"
command = "nvim"
color = "blue"
working-dir = "~/Code"

[[entries]]
name = "Codex"
command = "codex"
color = "bright-magenta"

[[entries]]
name = "Claude"
command = "claude"
color = "orange"

[[entries]]
name = "Tmux"
command = "tmux"
color = "cyan"
working-dir = "~/Code/project"
shell-program = "/bin/zsh"
shell-login = true

Layout settings:

Shell resolution order:

Relative working-dir resolution:

Supported entry colors:

Development

Use the provided Nix shell for the project toolchain:

nix-shell

Common commands:

make build
make test
make lint
nix-shell --command "make snapshots"