Terminal panels
Use the main terminal and independent dock tabs, run project actions, and understand session recovery.
Synara 1.0.1 keeps one main-view terminal per chat and supports multiple independent terminal tabs in the right dock. Each + → Terminal creates a shell session; switching tabs preserves sessions, closing one leaves the others running, and dock tabs restore after reload. Use mod+j to toggle the panel, or mod+shift+j for the full-width workspace. In that workspace, ctrl+1 and ctrl+2 switch between terminal and chat. Opening the terminal again focuses the existing session.
Run a project action
Project actions open in the right dock with the requested working directory and runtime environment, keeping the center chat unchanged, including in split chats. They replace only the selected idle dock terminal; other dock sessions remain running. If the selected dock terminal is busy, stop its work before running another action there. The server checks activity even after a reload, and refuses an action when it cannot establish that the session is idle. Opening a workspace path uses the same idle check before sending shell navigation input.
Close and reopen
An explicit close ends the terminal session. If closing fails, the pane stays visible and usable. Reopening after close or shell exit creates a new session identity, so delayed cleanup cannot terminate the replacement shell. Hiding the panel is separate from closing the session.
Upgrade an older terminal layout
Nested terminal tabs, groups, splits, and the bottom drawer are removed. Synara retains the last active terminal. Retired nested sessions close only after the server verifies they are idle; their saved history is preserved. Busy sessions or sessions whose activity cannot be checked remain pending for the next mount. Old terminal-split keybindings no longer intercept shell shortcuts.
See Keyboard shortcuts for the current keymap and provider accounts for account-specific terminal commands.
Source evidence: Synara v1.0.1, docs/core-concepts.md, apps/web/src/terminalStateStore.ts, apps/web/src/components/ThreadTerminalDrawer.tsx, apps/web/src/components/chat/DockTerminalPane.tsx, apps/server/src/terminal/Layers/Manager.ts, and apps/server/src/keybindings.ts.