From 5baf231e076ed96bb2aaba245eb53ad0e4501d76 Mon Sep 17 00:00:00 2001 From: Franz Bettag Date: Tue, 28 Apr 2026 19:11:11 +0200 Subject: Add named persistent sessions (#57) * feat: add named persistent sessions * feat: add session management commands * fix: tighten named session stop and override precedence * fix: handle session help and stop test race * test: isolate default session env test --------- Co-authored-by: Ogulcan Celik --- README.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'README.md') diff --git a/README.md b/README.md index 0ff1ef93..8ecaea54 100644 --- a/README.md +++ b/README.md @@ -41,7 +41,17 @@ herdr update herdr ``` -by default herdr launches or attaches to a background session server. `ctrl+b q` detaches the client. agents keep running. use `herdr server stop` to stop the server. use `--no-session` for the old single-process mode. +by default herdr launches or attaches to one background session server. `ctrl+b q` detaches the client. agents keep running. use `herdr server stop` to stop the default server. use `--no-session` for the old single-process mode. + +named sessions are runtime/socket namespaces for separate persistent herdr servers. they do not replace workspaces; each named session has its own panes, tabs, workspaces, sockets, and session state while sharing the same global config file. + +```bash +herdr --session work +herdr --session side-project +herdr session list +herdr session stop work +herdr session delete side-project +``` 1. press `n` to create a workspace 2. run an agent in the root pane -- cgit v1.2.3