explaingit

iogamaster/tuxedo.nvim

15LuaAudience · developerComplexity · 1/5LicenseSetup · moderate

TLDR

A Neovim plugin that opens the Tuxedo todo app in a floating window inside the editor, so you can manage your to-do list without switching away from your code, inspired by lazygit.nvim.

Mindmap

mindmap
  root((tuxedo.nvim))
    What it does
      Open Tuxedo in Neovim
      Floating window wrapper
      Stay inside the editor
    Configuration
      Auto-create todo file
      Window width ratio
      Window height ratio
    Usage
      Tuxedo command
      Lua function call
    Tech Stack
      Lua
      Neovim
      Tuxedo TUI app
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Access your Tuxedo todo list from inside Neovim without opening a separate terminal tab.

USE CASE 2

Configure the floating window size to take up a specific fraction of your editor screen.

USE CASE 3

Trigger the Tuxedo interface with a single command or keybinding while coding.

Tech stack

LuaNeovim

Getting it running

Difficulty · moderate Time to first run · 30min

Requires the Tuxedo TUI application installed separately on your system before the Neovim plugin will work.

Use freely for any purpose, including commercial, as long as you keep the copyright notice.

In plain English

tuxedo.nvim is a plugin for Neovim, a code editor used in the terminal. Its job is to open the tuxedo todo application inside a floating window within Neovim, so you can manage your to-do list without leaving the editor. The idea comes directly from lazygit.nvim, a popular plugin that opens the lazygit git interface the same way, embedded inside the editor rather than switching to a separate terminal tab. To use this plugin you need the tuxedo application already installed separately on your system. tuxedo is a TUI (terminal user interface) application for managing todo items. Once the Neovim plugin is loaded, you open tuxedo with the :Tuxedo command or by calling a Lua function directly. The plugin takes care of creating and positioning the floating window that wraps tuxedo's interface. Configuration is minimal. A setup call accepts three options: one to control whether the plugin creates a todo file automatically, and two others that set the floating window's width and height as fractions of the editor's current screen size. For example, setting width_ratio to 0.95 makes the window take up 95% of the available width. The README is sparse and the plugin is described as early-stage. There is no explanation of what the tuxedo application itself does beyond the description of it being a todo TUI, so users would need to look at the tuxedo repository separately to understand the underlying tool. The plugin is MIT-licensed and contributions are welcome according to the README.

Copy-paste prompts

Prompt 1
Set up tuxedo.nvim in my Neovim config using lazy.nvim, show me the plugin spec and the setup call with the floating window sized at 90% width and 80% height.
Prompt 2
I want to open Tuxedo with a custom keybinding in Neovim instead of typing :Tuxedo each time. Show me how to map a key to the Lua function tuxedo.nvim exposes.
Prompt 3
Walk me through installing the Tuxedo TUI app on macOS and then wiring up tuxedo.nvim so the floating window opens inside Neovim.
Prompt 4
How does tuxedo.nvim create its floating window? I want to fork it and add the same pattern to embed a different TUI app inside Neovim.
Open on GitHub → Explain another repo

← iogamaster on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.