nunchux

nunchux is a sophisticated application launcher designed for tmux that enhances terminal productivity by providing quick access to favorite TUI applications and project tasks. This tool acts as a command palette, simplifying navigation and management of running apps in a tmux environment.

Key Features

• Effortless App Management: Launch applications in popups or windows, and switch to them quickly if they are already running, eliminating the need to search through tmux windows.
• Real-Time Status Indicators: View the running status of each app with visual cues (● running, ○ stopped).
• Dynamic Menu Options: Direct access to project tasks through Justfile and package.json scripts, allowing users to run tasks without manual commands.

Justfile and npm Script Integration

If a Justfile is detected in your project directory, nunchux will list available recipes directly in the menu for easy execution. Similarly, accessing npm scripts defined in a package.json is straightforward and convenient.

Configuration Options

Custom configurations can be made via a straightforward config file located at ~/.config/nunchux/config. Users can customize settings such as menu dimensions, app popups, and the integration features:

[settings]
icon_running = ●
icon_stopped = ○
menu_width = 60%
menu_height = 50%
popup_width = 90%
popup_height = 90%
just_enabled = true
npm_enabled = true

Advanced Customization

Nunchux provides functionality for advanced users to include dynamic status updates for individual applications, supporting a wide range of commands and customizable display options. Examples include monitoring git status for a project or displaying system load metrics.

[git]
cmd = lazygit
status = n=$(git status -s 2>/dev/null | wc -l); [[ $n -gt 0 ]] && echo "($n changed)"

Getting Started

While installation instructions are detailed in the project, the default invocation key can be easily customized, allowing users to launch the menu with their preferred keyboard shortcut. For seamless integration, it is recommended to use the tmux Plugin Manager (TPM) to manage nunchux installation easily.

Dependencies

To ensure full functionality, nunchux requires dependencies such as tmux, fzf, and optionally curl and jq for enhanced user experience.

By streamlining the management of terminal applications, nunchux significantly improves productivity and maintains organized workflows within the tmux interface. Whether it’s for developers managing multiple projects or power users looking to enhance terminal efficiency, nunchux offers innovative solutions to everyday terminal challenges.