Sessions¶
A session is a workspace containing tabs, panes, and their running programs. Use separate sessions for different projects or tasks.
Switch sessions¶
Open Sessions () → All Sessions… to see sessions on this computer and connected servers.
Switching sessions leaves the others running.
Leave and return¶
Closing a window (×) asks whether to Detach or Kill Server. Detach closes the window and keeps its session and programs running. Reopen the session from All Sessions… to continue where you left off.
Detached programs still depend on the server computer staying awake and running. A reboot ends them.
From the command line¶
Create a named session and open it:
To create it in the background instead:
List running sessions and return to one:
- Inside Graffitty,
attach-sessionswitches the calling window. - Outside Graffitty, it opens a window for that session.
- Use the session's name or its
$IDfrom the listing. Quote IDs, for example-t '$12'. gft list-sessions --jsonprints session records for scripts.
Rename a session without ending its programs:
End a session¶
Closing a window never ends its session. To end sessions:
- Kill Session: right-click a session in the Sessions panel.
- Kill Server (in the window close dialog, this computer only): ends every local session, including detached ones.
- Close a session's last pane.
Right-click a session in the Sessions panel and choose Kill Session to end it without closing any window.
From the command line, gft kill-session -t project ends the named session and
all its panes and programs. To keep them running, use Detach instead.
When the session a window shows ends this way, or through its last pane, the window switches to another session that no other window is showing. If every remaining session is already open elsewhere, the window closes. Graffitty quits only when no session or connected server is left to show.