RunHuddleDocs

These guides cover the 0.36.2 workspace. Older releases may differ. Check release notes ↗

Documentation / Session lifecycle and cleanup

Session lifecycle and cleanup

Keep terminals running, end sessions, archive history and understand deletion.

Keep work running

Changing views or closing the main window does not stop a terminal. On quit, choose whether to keep terminals running or end sessions. Kept terminals reconnect with their history when RunHuddle reopens. In-app updates preserve and reconnect running terminals. A Mac restart ends processes, although recorded conversations may still be resumed.

Project shortcut commands have a different lifecycle: they stop on app exit.

End a session

Use the terminal’s action menu and End session… to stop its agent. End and archive… waits for the provider to confirm closure before opening archive review. Codex can take about a minute to unload after its terminal ends; another attached client can delay confirmation.

An ended terminal offers recorded conversation, resume and terminal-output inspection. Do not treat a delayed status update as permission to launch the same conversation again.

For shell terminals, ending closes the PTY and interrupts attached commands. Detached background processes can survive. Shells do not use agent archive/resume actions.

Archive and restore

Archive only sessions confirmed closed. Codex uses native archive operations. Claude and Copilot archives hide the session in RunHuddle while preserving original histories. Restore from Archived. A session detected running again returns to the main list.

Bulk actions

Choose Bulk actions, select rows or Select all results, then review the operation. Selection can span filters. The review identifies eligible sessions and explains skipped selections.

Archive and delete… archives eligible closed histories and then removes the reviewed set. Delete archived… removes histories already archived. Running sessions and those with uncertain liveness are skipped; liveness and the affected set are checked again before removal. Partial failures are reported and may leave some histories archived.

Deletion and independent notes

Codex history deletion is permanent. Claude and Copilot Move history to Trash removes the reviewed history files, not project files. Save or export important knowledge before deleting.

Project notes are independent records and remain after session cleanup. Deleting a note is a separate confirmed operation. Notes are not a complete transcript backup. See Privacy and data for storage and backup boundaries.