based

based is a small authenticated web UI for creating and attaching to local tmux sessions.

Run

Set credentials once:

based set-credentials -username admin -password secret

This writes credentials and app config to ./config/.env. By default, runtime data is stored in ./data/main.sqlite.

Start the server:

based serve

Open http://localhost:37491 to view the application docs, then use http://localhost:37491/login to log in. After login, create a session from /sessions and open it from the session list.

Detach without killing the shell

Terminal pages include a Detach button in the top-right corner. Use it when you want to leave the browser terminal but keep the tmux session, shell, and running commands alive.

Detaching returns you to the session list. Reopen the same session later to continue exactly where you left off.

Closing the browser tab or losing the WebSocket connection also detaches the web client from tmux instead of killing the shell process.

Inside the terminal, tmux's normal detach key binding still works too:

Ctrl-b d

That key sequence detaches from tmux and leaves the session running.