CLI
Run, search and schedule Claude Code and Codex agents from tmux
komradKomrad runs coding agents in tmux panes and keeps track of them.
There are two processes. komrad serve is the long-lived server 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.
komrad open brings the panel up in this terminal, and the other commands are
for the times something has to be done by hand: check the machine, start or stop
the server, 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, and who may use them
komrad forge#Connect komrad to the services pull requests live on
komrad github#Reach GitHub as the engine's own App
komrad gitlab#Reach GitLab with the token its forge connection holds
komrad hook#Run one of the agent CLI hooks komrad installs
komrad log#Show the log lines the server wrote under one trace id
komrad login#Sign in to an engine reached at its url
komrad logout#Sign out of an engine reached at its url
komrad migrate#Apply any pending database migrations
komrad open#Open the panel in this terminal, 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 server's endpoints, one subcommand per RPC
komrad serve#Run the komrad server in the foreground
komrad setup#Set this machine up for komrad, asking for whatever is missing
komrad shell#Open a shell on the engine in a directory an agent works in
komrad ssh-proxy#Carry an SSH connection to the engine over its api
komrad start#Start the server in the background if it is not already running
komrad stop#Ask the running server to stop, and wait until it is gone
komrad terminal#Attach to an agent's terminal on the engine
komrad token#Print an ID token for an engine reached at its url
komrad version#Print which build this binary is, and which one is serving
komrad visual#Run the stand-in visual mode selects in