# CLI

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

```bash
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

-   [`komrad attach`](https://komrad.dev/latest/cli/attach.md)
    
    Attach the running panel in this terminal
    
-   [`komrad doctor`](https://komrad.dev/latest/cli/doctor.md)
    
    Check that this machine has everything komrad needs
    
-   [`komrad engine`](https://komrad.dev/latest/cli/engine.md)
    
    Set up the engines that share a database, and who may use them
    
-   [`komrad forge`](https://komrad.dev/latest/cli/forge.md)
    
    Connect komrad to the services pull requests live on
    
-   [`komrad github`](https://komrad.dev/latest/cli/github.md)
    
    Reach GitHub as the engine's own App
    
-   [`komrad gitlab`](https://komrad.dev/latest/cli/gitlab.md)
    
    Reach GitLab with the token its forge connection holds
    
-   [`komrad hook`](https://komrad.dev/latest/cli/hook.md)
    
    Run one of the agent CLI hooks komrad installs
    
-   [`komrad log`](https://komrad.dev/latest/cli/log.md)
    
    Show the log lines the server wrote under one trace id
    
-   [`komrad login`](https://komrad.dev/latest/cli/login.md)
    
    Sign in to an engine reached at its url
    
-   [`komrad logout`](https://komrad.dev/latest/cli/logout.md)
    
    Sign out of an engine reached at its url
    
-   [`komrad migrate`](https://komrad.dev/latest/cli/migrate.md)
    
    Apply any pending database migrations
    
-   [`komrad open`](https://komrad.dev/latest/cli/open.md)
    
    Open the panel in this terminal, creating or attaching its persistent session
    
-   [`komrad panel`](https://komrad.dev/latest/cli/panel.md)
    
    Run the panel itself, as the manager session's own command
    
-   [`komrad pr`](https://komrad.dev/latest/cli/pr.md)
    
    Read pull requests through the forges komrad is connected to
    
-   [`komrad rpc`](https://komrad.dev/latest/cli/rpc.md)
    
    Call the server's endpoints, one subcommand per RPC
    
-   [`komrad serve`](https://komrad.dev/latest/cli/serve.md)
    
    Run the komrad server in the foreground
    
-   [`komrad setup`](https://komrad.dev/latest/cli/setup.md)
    
    Set this machine up for komrad, asking for whatever is missing
    
-   [`komrad shell`](https://komrad.dev/latest/cli/shell.md)
    
    Open a shell on the engine in a directory an agent works in
    
-   [`komrad ssh-proxy`](https://komrad.dev/latest/cli/ssh-proxy.md)
    
    Carry an SSH connection to the engine over its api
    
-   [`komrad start`](https://komrad.dev/latest/cli/start.md)
    
    Start the server in the background if it is not already running
    
-   [`komrad stop`](https://komrad.dev/latest/cli/stop.md)
    
    Ask the running server to stop, and wait until it is gone
    
-   [`komrad terminal`](https://komrad.dev/latest/cli/terminal.md)
    
    Attach to an agent's terminal on the engine
    
-   [`komrad token`](https://komrad.dev/latest/cli/token.md)
    
    Print an ID token for an engine reached at its url
    
-   [`komrad version`](https://komrad.dev/latest/cli/version.md)
    
    Print which build this binary is, and which one is serving
    
-   [`komrad visual`](https://komrad.dev/latest/cli/visual.md)
    
    Run the stand-in visual mode selects in
    

## Flags

| Flag | Type | Description |
| --- | --- | --- |
| [`--config`](https://komrad.dev/latest/cli.md#flag-config) | stringArray | path to a config TOML, repeatable, later files win over earlier ones |
| [`--engine`](https://komrad.dev/latest/cli.md#flag-engine) | string | engine to reach: local for this machine, or a file in the config's engines directory, layered over the config |
