oss

tmux-ide is an open-source project by Prototyper.View source(opens in a new tab)

tmux-ide home

tmux-ide 2.9.21

Lua plugins: add your own commands to the palette and the CLI, with consent before a plugin runs.


2.9.21 is a CLI/daemon release. It works with native macOS alpha 0.1.14. Plugin commands in the Mac app's palette arrive with the next Mac app update.

Plugins

A plugin is a small Lua program that adds commands to the TUI's F5 palette and to tmux-ide action. Try the example, which turns git worktrees into tasks you can start, open and remove:

tmux-ide plugin example worktree-tasks
tmux-ide plugin consent worktree-tasks

A plugin in ~/.tmux-ide/plugins/ runs only after you allow it. Consent lists what it asks to do, such as running programs, typing into panes or creating worktrees. If the plugin's files change, it stops at the next reload or daemon restart until you allow it again. On macOS, programs a plugin runs are kept away from tmux-ide's private files (the daemon's record, consent records, plugin stores and app settings) and the daemon, and from the tmux server unless the plugin may type into panes. On Linux, plugins cannot run programs unless you set TMUX_IDE_PLUGIN_EXEC_LINUX=1.

Read Plugins for the API, capabilities and limits.

New commands

  • tmux-ide plugin list, reload, logs, consent, revoke and example
  • tmux-ide action list and tmux-ide action run
  • tmux-ide lua run, lua api and lua describe
  • tmux-ide worktree create --plain

See Commands.

Update the CLI/daemon with tmux-ide update. Existing tmux sessions are preserved. Full list of changes: CHANGELOG.md.