komrad

CLI

Run, search and schedule Claude Code and Codex agents from tmux

komrad

Komrad 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#

Flags#

FlagTypeDescription
--configstringArray

path to a config TOML, repeatable, later files win over earlier ones

--enginestring

engine to reach: local for this machine, or a file in the config's engines directory, layered over the config