tmux-botdomo 0.2.0

Majordomo of AI assistants living in tmux sessions
Documentation

tmux-botdomo

Majordomo of AI assistants living in tmux sessions.

Automatically detects Claude Code, Gemini, and Codex running in tmux panes and allows you to send context directly from vim to the right AI assistant.

Installation

cargo install tmux-botdomo

Setup

1. Start the daemon

Add to your .tmux.conf:

set-hook -g server-start "run-shell 'tbdmd start'"

Note that session-closed hook is currently broken in tmux 3.5a and doesn't get triggered as expected. Therefore, tbdmd automatically shuts down when it detects the tmux session no longer exists.

2. Configure vim

Add to your .vimrc or init.vim:

vnoremap <leader>c :'<,'>!tbdm send<CR>

Or for Neovim with Lua:

vim.keymap.set('v', '<leader>c', ':!tbdm send<CR>', { silent = true })

Usage

  1. Select code in vim/Neovim.
  2. Press your configured keybinding.
  3. Selected conetext is sent to the detected AI assistant in your tmux session, based on the working directories.

Commands

tbdm status     # Check daemon status
tbdm send        # Send context to AI assistant (typically called from vim)