komrad open

Open the panel popup over the current tmux session.

It creates the manager session if it is not there and attaches either way, so the panel keeps its place between opens rather than starting over. The manager session lives on komrad's own tmux server, so it does not show up in tmux ls.

With engine files under the config's engines directory and no --engine given, it first asks which komrad to open, this machine or one of them, and runs itself again on the one chosen. Closing that panel comes back to the question, and closing the question closes the popup. An engine running other code than this komrad cannot be chosen.

The tmux plugin runs this as the popup's command, so it blocks until the client detaches, which is what closes the popup. Pressing the panel key again runs komrad hide. Run by hand outside a popup it attaches the manager session in the terminal instead, which is the panel without the popup around it.

With --detach it creates the session and returns, which is what a script wants when it needs somewhere for agents to be put back into.

With --headless it creates that session holding nothing but a placeholder, for an engine whose panel runs on somebody else's machine and which would otherwise swap an agent's pane into a panel nobody is looking at.