Skip to content

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:

gft new-session -s work

To create it in the background instead:

gft new-session -d -s build -c /path/to/project

List running sessions and return to one:

gft list-sessions
gft attach-session -t work
  • Inside Graffitty, attach-session switches the calling window.
  • Outside Graffitty, it opens a window for that session.
  • Use the session's name or its $ID from the listing. Quote IDs, for example -t '$12'.
  • gft list-sessions --json prints session records for scripts.

Rename a session without ending its programs:

gft rename-session -t work project

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.