Session Persistence
Conductore automatically saves and restores its full state across restarts, including terminal layouts, pane assignments, and sidebar widths.
What is persisted
On every meaningful state change, Conductore saves:
- Terminal list — all terminal configurations (name, project, shell, order, alive/done status)
- Split layout — the current pane layout type (single, quad, etc.)
- Pane assignments — which terminal is in which pane position
- Sidebar widths — left and right sidebar sizes
- Active terminal ID — which terminal was focused
- Settings — all user preferences
- TUI app state — which TUI app was active in the slide-out panel
What is NOT persisted
- Terminal output history — the scrollback buffer is not saved. Terminals re-open to a fresh shell on restart.
- Running processes — any processes started in a terminal (node servers, watchers, etc.) are not restarted
- Pane split widths — pane proportions within a layout are not saved (panes split evenly on restore)
Restore on startup
On launch, Conductore:
- Reads the persisted state from electron-store
- Recreates all terminal configurations in the sidebar
- Applies the saved layout
- Assigns terminals to panes in the saved order
- Opens fresh PTY processes for each terminal that was alive at shutdown
Terminals that were marked done are restored in their done state (greyed out) but do not have a PTY process created for them.
Terminal startup commands
If a project has a startup command configured (Settings → Workspace), it runs automatically in each recreated terminal. Use this to:
- Re-activate virtual environments
- Export environment variables
- Navigate to the right directory
Where state is stored
State is stored in electron-store, which persists to a JSON file in the OS app data directory:
- Windows:
%APPDATA%\conductore-lite\ - macOS:
~/Library/Application Support/conductore-lite/ - Linux:
~/.config/conductore-lite/
You can inspect or back up this directory. However, editing the raw JSON directly is not recommended.
Clearing state
To reset Conductore to a fresh state:
- Close Conductore completely
- Delete the
conductore-litefolder from your app data directory - Relaunch — you'll go through the initial setup (root folder scan)
Or, to reset just the terminal layout without touching settings, use Settings → Advanced → Clear Session State.