A tmux plugin that creates a 3-pane IDE layout with a single keybinding. Turns any tmux window into a development workspace with your editor, an AI coding agent, and a terminal.

+----------------------------------------+-------------------+
|                                        |                   |
|   editor (nvim)                        |   agent (opencode)|
|   (top-left)                           |   (right)         |
|                                        |   (full height)   |
|                                        |                   |
|----------------------------------------|                   |
|   terminal (bash)                      |                   |
|   (bottom-left)                        |                   |
+----------------------------------------+-------------------+

Defaults to nvim as the editor and OpenCode as the right-side AI agent, but both are fully configurable. Works with any editor and any terminal-based tool.

git clone https://github.com/guysoft/tmux-ide ~/.tmux/plugins/tmux-ide
~/.tmux/plugins/tmux-ide/install.sh

Then inside tmux, press prefix + e to create the IDE layout.

• tmux >= 2.0
• An editor (default: Neovim)
• An AI agent or tool for the right pane (default: OpenCode)

git clone https://github.com/guysoft/tmux-ide ~/.tmux/plugins/tmux-ide && ~/.tmux/plugins/tmux-ide/install.sh

This will:

1. Symlink the plugin into ~/.tmux/plugins/tmux-ide/
2. Create an ide command in ~/.local/bin/ for command-line usage
3. Add the plugin to ~/.tmux.conf (before tpack/TPM init if present)
4. Reload your tmux config

tpack is a modern drop-in replacement for TPM with a TUI, written in Go. Install it via Homebrew (brew install tmuxpack/tpack/tpack) or see the tpack installation guide.

Add this line to your ~/.tmux.conf, before the tpack init line:

set -g @plugin 'guysoft/tmux-ide'

# Initialize tpack (keep at the very bottom)
run 'tpack init'

Then press prefix + I to install.

Add this line to your ~/.tmux.conf, before the TPM init line:

set -g @plugin 'guysoft/tmux-ide'

# Initialize TPM (keep at the very bottom)
run '~/.tmux/plugins/tpm/tpm'

Then press prefix + I to install.

To also get the ide CLI command, run:

~/.tmux/plugins/tmux-ide/install.sh

Clone the repo and source the plugin:

git clone https://github.com/guysoft/tmux-ide ~/.tmux/plugins/tmux-ide

Add to ~/.tmux.conf:

run-shell ~/.tmux/plugins/tmux-ide/tmux-ide.tmux

~/.tmux/plugins/tmux-ide/install.sh --remove

Press prefix + e to transform the current tmux window into an IDE layout.

The layout uses the current pane's working directory as the project root:

• Editor opens in the project directory (nvim with your session auto-loaded if using a session plugin)
• Agent opens in the project directory (opencode continues the last session for that directory)
• Terminal opens in the project directory
• Window is renamed to the project directory name

If the window already has multiple panes, they are replaced.

The ide command (installed by install.sh) can be used directly:

# Create IDE layout in current directory
ide

# Create IDE layout for a specific project
ide ~/workspace/myproject

# Skip confirmation when replacing existing panes
ide --force ~/workspace/myproject

# Open a new tmux window
# Ctrl+a c

# Navigate to your project
cd ~/workspace/myproject

# Press prefix + e to create IDE layout
# Ctrl+a e

# Or from command line:
ide ~/workspace/myproject

All options are set in ~/.tmux.conf:

set -g @plugin 'guysoft/tmux-ide'
# No extra config needed, these are the defaults

set -g @plugin 'guysoft/tmux-ide'
set -g @ide-agent "claude"

set -g @plugin 'guysoft/tmux-ide'
set -g @ide-editor "vim"
set -g @ide-agent "aider"

set -g @plugin 'guysoft/tmux-ide'
set -g @ide-editor "hx"
set -g @ide-agent "goose"

set -g @plugin 'guysoft/tmux-ide'
set -g @ide-right-width "40"
set -g @ide-bottom-height "25"

This plugin works well with tmux-resurrect and tmux-continuum. After a tmux restart, the full IDE layout is restored:

# Plugins
set -g @plugin 'tmux-plugins/tmux-resurrect'
set -g @plugin 'tmux-plugins/tmux-continuum'
set -g @plugin 'guysoft/tmux-resurrect-opencode-sessions'
set -g @plugin 'guysoft/tmux-ide'

# Auto-save and restore
set -g @continuum-restore 'on'

# Initialize tpack (keep at the very bottom)
run 'tpack init'

Note: If using TPM instead of tpack, replace run 'tpack init' with run '~/.tmux/plugins/tpm/tpm' and add set -g @plugin 'tmux-plugins/tpm' to the plugins list.

tmux-ide exposes the nvim RPC socket as NVIM_IDE_SOCK, enabling AI agents to programmatically control nvim's debugger from outside. This is a key piece of the debug-reach feature that allows an agent to set breakpoints, launch debug sessions, and inspect state — all via RPC.

This feature requires all three repos working together:

The socket is available to any process in the tmux session:

NVIM_IDE_SOCK=$(tmux show-environment NVIM_IDE_SOCK | sed 's/^NVIM_IDE_SOCK=//')
nvim --server "$NVIM_IDE_SOCK" --remote-expr "luaeval('vim.fn.getcwd()')"

• tmux-resurrect-opencode-sessions - Preserves OpenCode sessions across tmux restarts
• tmux-resurrect - Save and restore tmux sessions
• tmux-continuum - Automatic save and restore

GPL-3.0. See LICENSE for details.