RunHuddleSession views and status
| View or state | Meaning |
|---|---|
| Active | Confirmed live sessions, grouped by input needed, working and idle. |
| All | Live and previous sessions, excluding archived records. |
| Pinned | Your pinned, unarchived sessions. |
| Archived | Sessions you have archived. |
| Working | The agent reports work in progress. |
| Needs input | The agent reports a question, approval or other input request. |
| Idle | A live session is ready for another prompt or review. |
| Previous session | Recorded history exists without confirmed live activity. |
Previous session does not always mean a verified process exit. Open Session info to see whether tracking is unavailable or the session has ended. An idle state or completion notification is not proof that the task succeeded.
Search and filter
Use All tools and All projects to narrow the list. The project picker supports search and full-path hints. Temporary or missing directories are grouped under Temporary / other without deleting their histories.
Press ⌘F to search titles, projects and recorded conversation text. Search starts in Current view. Choose Search all sessions to include other states and archived history while retaining tool and project filters. Clear the query with ×, Escape or Done. Notes have their own search and filters.
Right-click a session to rename, pin, generate a handoff, save a project note or review eligible archive actions.
Work in the embedded terminal
Select a running RunHuddle-owned session to open its terminal. Type prompts, commands and approvals directly in it. Switching views does not stop agents. Clipboard images are saved locally and pasted as file references; interpretation depends on the chosen agent and model.
External sessions show recorded conversation rather than an interactive terminal. RunHuddle no longer discovers, focuses or launches Terminal.app, Ghostty or iTerm2 windows. Exit the external agent before choosing Resume this session in RunHuddle.
Use ⌘⇧L to show or hide the session list and ⌘⇧I for Session info. The two pane buttons remain available above the workspace. Drag the divider to resize panes; double-click to reset it. Narrow windows adapt the layout. ⌘⇧R refreshes session data without restarting terminals.
Menu-bar switcher
Click the RunHuddle mark in the menu bar. The default shortcut is Control–Option–Space; change or disable it in Settings → General. Your configured shortcut may differ.
Search, use the arrow keys to choose a session and press Return to open it. Escape dismisses the switcher. RunHuddle sessions open their embedded terminals; external sessions open recorded conversation.
Plain shell terminals
Choose the arrow beside New session → Open terminal…, select a folder and open the terminal. RunHuddle uses your macOS login shell. Shell tabs are grouped under Terminals; the + button creates another, defaulting to the selected tab’s folder.
Right-click a tab to rename it, show its folder, copy its path or end it. The overflow menu keeps tabs reachable at narrow widths. Switching tabs preserves running processes and history. Splits and tab rearranging are not available.
Starting an agent manually inside a shell does not turn that shell into an agent-owned session. When RunHuddle can uniquely match its foreground agent to a conversation, opening either entry returns to the same shell tab. A shared folder alone is not enough for a match.
Closing a running shell tab asks before ending the shell and attached commands. Detached background processes may survive. Ended shells can be inspected or dismissed; they do not have agent archive or resume actions.
Context, compactions and checklists
Context percentages appear only when supported agent evidence is available. They are estimates, can decrease after compaction and are not a restart countdown. Observed compaction counts reflect available records rather than a guaranteed lifetime total.
Session info → Agent checklist displays supported structured task progress, not checkboxes inferred from prose. Expand it for steps, source and update time. Disable it in General settings if preferred. Checked steps are agent-reported, not independently verified results. No agent checklist reported does not mean the agent is idle.
Session cards no longer show handoff-status or saved-note icons. Review freshness inside the handoff dialog and find project note counts in Session info.