group

turnout group <add|list|show|edit|remove> [...]

A group is a named set of apps. Its purpose is one command:

turnout use contour staging    # every app in the group now points at staging

use accepts a group name anywhere an app name works; each member’s server allow-list is validated before anything is bound, so the switch is all-or-nothing.

add

turnout group add                                # wizard: pick apps from a list
turnout group add contour --app web --app api    # scripted
turnout group add contour -a web -a api          # same, short form

Flag	Short	Description
--app	-a	App to include (repeatable)

Group names must not clash with app names.

list / show

turnout group list           # groups and their members
turnout group show contour   # members and where each one points now

Omit the name on a terminal and turnout offers a picker; edit and remove do the same.

edit / remove

turnout group edit contour --add-app admin --rm-app api
turnout group remove contour [--yes]     # apps themselves are untouched

Flag	Short	Description
--add-app	-a	Add an app (repeatable)
--rm-app	-r	Remove an app (repeatable)

Removing an app from the catalog removes it from its groups too; a group left empty disappears.