git/tmux_popup
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
9 commits 2 branches 0 tags 55 KiB
Find a file
Renovate Bot dd9b6b68cc Add renovate.json
2025-06-04 15:43:36 +00:00
go.mod refactor: change from args to usage of cobra 2024-12-25 08:09:41 +01:00
go.sum refactor: change from args to usage of cobra 2024-12-25 08:09:41 +01:00
main.go fix: add error checking while starting tmux floating window 2024-12-25 08:53:08 +01:00
main_test.go test: add basic tests for application 2024-12-25 08:18:22 +01:00
README.md docs: add README.md 2024-12-25 09:04:19 +01:00
renovate.json Add renovate.json 2025-06-04 15:43:36 +00:00

README.md

tmux_popup

tmux_popup is a command-line tool that allows you to open various programs inside floating popups in tmux. It supports opening tmux, lazygit, harlequin, and postings programs within a tmux session as popups. This tool helps streamline your workflow by launching and interacting with these tools directly in tmux, without leaving your terminal environment.

Features

  • Open tmux in a floating popup.
  • Open lazygit, harlequin, and postings inside tmux popups.
  • Check if the required dependencies are installed.
  • Customizable popup width and height.

Installation

Ensure you have the following tools installed:

  • tmux
  • lazygit
  • harlequin
  • posting

To install the tmux_popup CLI tool, you can build it from source or use pre-built binaries, if available.

Build from Source

  1. Clone the repository:

    git clone https://github.com/yourusername/tmux_popup.git
cd tmux_popup

  2. Build the application using Go:

go build -o tmux_popup
  1. Add the binary to your system's PATH for easier access.

Usage

Once installed, you can use the tmux_popup tool from your terminal. The basic command syntax is:

tmux_popup <command> [options]

Commands

  • tmux: Opens a tmux popup.
tmux_popup tmux [--width=<width>] [--height=<height>]
  • lazygit: Opens lazygit in a tmux popup.
tmux_popup lazygit [--width=<width>] [--height=<height>]
  • harlequin: Opens harlequin in a tmux popup.
tmux_popup harlequin [--width=<width>] [--height=<height>]
  • postings: Opens postings in a tmux popup.
tmux_popup postings [--width=<width>] [--height=<height>]
  • check: Checks if the required dependencies are installed.
tmux_popup check

Options

  • --width: The width of the popup (e.g., 80% or 100).
  • --height: The height of the popup (e.g., 80% or 100). If you don't specify these options, default values (80% for both width and height) will be used.

Example Usage Open a tmux session in a floating popup:

tmux_popup tmux

Open lazygit in a floating popup with custom width and height:

tmux_popup lazygit --width=100 --height=70

Check if dependencies are correctly installed:

tmux_popup check

Error Handling

If you run into issues with tmux_popup, check that:

  • You have tmux, lazygit, harlequin, and posting installed and accessible in your PATH.
  • You have a running tmux session.

License

tmux_popup is released under the MIT License.