TmuxAI

tmuxai

An AI-powered terminal assistant for tmux

Runs as tmuxai|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Command form

ai-draft · 1 task · 6 fields

Start TmuxAI with an optional first message, task file, model, knowledge bases and explicit tmux panes. Yolo mode is left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui tmuxai

Start TmuxAIExample values, fixed in this page — nothing here reaches a terminal

Basic

Initial message*

string

Model configuration

string

TasksEach one presets the form for one job

Start with a message

messagemodel

ParametersOnly these flags are editable in the form

Initial message

string · positional 0

Task file

path

-f

Model configuration

Name of a model configuration from your config.
string

--model

Knowledge bases

Comma-separated names.
string

--kb

Exec pane ID

tmux pane ID such as %3.
string

--exec-pane

Read panes

Comma-separated tmux pane IDs.
string

--read-panes

SourcesEvery flag above is checked against these

readme

tmuxai your initial message tmuxai -f path/to/your_task.txt tmuxai --model gpt4 "Write a Go function" tmuxai --kb docker-workflows,git-conventions tmuxai --exec-pane %3 --read-panes %1,%2 tmuxai --model gpt4 --kb docker-workflows --exec-pane %3 --read-panes %1,%2 "Debug this Docker issue"

manual2026-10-27

github.com

Before it fills your prompt, Otty checks the installed tmuxai against its version. A form that does not match your version is not offered.