komradkomrad
tmux panel and CLI for background coding agents
komradKomrad runs coding agents in tmux panes and keeps track of them.
There are two processes. komrad serve is the long-lived service that owns the
database, answers the API and the MCP endpoint, and watches every pane. The panel
is a client of it, which is why it can be closed and reopened without stopping
anything. Every other command here is a client of the same service.
The panel is normally reached through the tmux key binding rather than by name, and the commands below are for the times something has to be done by hand: check the machine, start or stop the service, or call an endpoint from a script.
Commands#
komrad attach#Attach the running panel in this terminal
komrad doctor#Check that this machine has everything komrad needs
komrad engine#Set up the engines that share a database
komrad forge#Connect komrad to the services pull requests live on
komrad github#Reach GitHub as the engine's own App
komrad hide#Hide the panel popup without stopping anything
komrad hook#Run one of the agent CLI hooks komrad installs
komrad log#Show the log lines the service wrote under one trace id
komrad migrate#Apply any pending database migrations
komrad open#Open the panel popup, creating or attaching its persistent session
komrad panel#Run the panel itself, as the manager session's own command
komrad pr#Read pull requests through the forges komrad is connected to
komrad rpc#Call the service's endpoints, one subcommand per RPC
komrad serve#Run the komrad service in the foreground
komrad shown#Say in the exit status whether the panel is on screen on this tmux server
komrad start#Start the service in the background if it is not already running
komrad stop#Ask the running service to stop, and wait until it is gone
komrad tmux#Bind the panel key on your tmux server
komrad version#Print which build this binary is, and which one is serving