How do I install tuis.nvim with packer.nvim?

tuis.nvim can be installed with packer.nvim by adding it to your plugin list in init.lua, similar to the lazy.nvim example in the README. Ensure you include any necessary configuration for keymaps, and note that it depends on morph.nvim.

tuis.nvim vs lazygit for Git management?

tuis.nvim includes a GitHub UI for issues and PRs, but it's not a full Git client like lazygit, which offers more repository operations. Use tuis.nvim for integrated tool management within Neovim, but for advanced Git workflows, lazygit might be better.

Can I customize the keybindings in tuis.nvim?

Yes, keybindings can be customized by overriding the default mappings in your Neovim configuration. The README shows examples using vim.keymap.set, allowing you to adapt the bindings to your workflow.

Does tuis.nvim work on Windows?

tuis.nvim is primarily designed for Unix-like systems (Linux and macOS) due to integrations with systemd and launchd. Windows support may be limited, especially for system monitoring features, and it hasn't been explicitly tested per the README.

How to add a new TUI to tuis.nvim?

Adding a new TUI requires creating a Lua module in the tuis/uis directory, following the existing patterns and using the morph.nvim framework. This involves defining UI layouts and functionality, which needs Lua programming knowledge.

What happens if I don't have Docker installed?

If Docker is not installed, the Docker UI in tuis.nvim will fail or show errors, but other UIs like processes or Hacker News should still function independently, as they don't rely on Docker.

Open-Awesome

tuis.nvim

Lua

A collection of interactive terminal user interfaces for Neovim to manage processes, containers, cloud resources, and developer tools.

GitHub

148 stars2 forks0 contributors

What is tuis.nvim?

tuis.nvim is a Neovim plugin that provides a collection of interactive terminal user interfaces (TUIs) for managing various command-line tools and services directly within the editor. It transforms CLI workflows for Docker, Kubernetes, cloud providers, system processes, and developer tools into visual, keyboard-driven interfaces that run natively in Neovim.

Target Audience

Neovim users who regularly work with Docker, Kubernetes, cloud services, or system monitoring tools and want to manage these resources without leaving their editor. It's particularly valuable for developers who prefer keyboard-driven workflows and want to reduce context switching between terminal and editor.

Value Proposition

Developers choose tuis.nvim because it provides consistent, interactive TUIs for multiple tools within Neovim, eliminating the need to switch between terminal tabs or external applications. The plugin offers rich functionality like process management, container operations, and cloud resource viewing with uniform keybindings across all interfaces.

Overview

A collection of TUIs for Neovim

Use Cases

Best For

Managing Docker containers and images directly from Neovim
Viewing and interacting with Kubernetes resources without leaving the editor
Monitoring system processes and resources within a Neovim workflow
Browsing cloud resources (AWS, GCP) from the terminal
Reading Hacker News or GitHub issues in a TUI interface
Managing LSP servers and Bitwarden vault items in Neovim

Not Ideal For

Teams using graphical IDEs like VS Code or JetBrains products for all development workflows
Environments that rely heavily on web-based dashboards for cloud resource management and monitoring
Workflows requiring batch automation or scripting beyond interactive TUI control
Projects where external CLI tools (e.g., Docker, kubectl) are not installed or managed centrally

Pros & Cons

Pros

Comprehensive Tool Integration

Unifies management for Docker, Kubernetes, cloud providers, system processes, and developer tools into a single plugin, reducing context switching as shown in the features list.

Consistent Keyboard Workflow

All UIs follow uniform keybindings like g? for help and <Leader>r for refresh, ensuring a seamless, keyboard-driven experience across different tools.

Deep Neovim Integration

Built specifically for Neovim with Lua configuration, allowing easy installation via package managers like lazy.nvim and customizable keymaps per the README examples.

Rich Interactive Features

Offers advanced capabilities such as process signaling, container exec, and resource inspection directly within TUIs, detailed in the keybindings table for actions like kill, logs, and shell access.

Cons

External Tool Dependencies

Requires external CLI tools (e.g., docker, kubectl, aws-cli) to be installed and configured, which can be a setup hurdle if not already in place.

Experimental Components

Features like the plugin store are marked as experimental in the README, indicating potential instability or incomplete functionality.

Limited to Neovim Ecosystem

Exclusively works within Neovim, making it unsuitable for users of other editors or environments, and it lacks support for graphical interfaces.

Potential Performance Overheads

Handling large datasets, such as numerous Kubernetes resources or cloud instances, might be slower in a terminal TUI compared to dedicated tools with optimized visualizations.

Frequently Asked Questions

Related Projects

noice.nvim

💥 Highly experimental plugin that completely replaces the UI for messages, cmdline and the popupmenu.

Stars5,792

Forks174

Last commit8 months ago

nvim-notify

A fancy, configurable, notification manager for NeoVim

Stars3,570

Forks100

Last commit10 months ago

visual-whitespace.nvim

Imitate VSCode's "Render Whitespace" feature in visual mode

Stars477

Forks8

Last commit1 month ago

cybu.nvim

Neovim plugin that offers context when cycling buffers in the form of a customizable notification window.

Stars326

Forks10

Last commit2 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub