Skip to main content

Session History

Session History lets you browse, search, and resume past AI coding sessions. Every session you run is recorded with metadata, so you can pick up where you left off days or weeks later.

Opening Session History​

Open the history panel with Cmd+Shift+H (macOS) or Ctrl+Shift+H (Windows/Linux). You can also access it from the top bar of the app.

The panel shows a chronological list of past sessions with the following information for each entry:

  • First prompt — The initial message you sent to the AI
  • Message count — How many messages were exchanged
  • Branch — The git branch the session was running on
  • Start and end dates — When the session began and finished

Searching and Filtering​

Use the search bar at the top of the history panel to find sessions by keyword. Search is debounced, so results update as you type without requiring you to press Enter.

You can also filter sessions by branch using the branch dropdown. This is helpful when you want to find all the work done on a specific feature branch.

Sorting​

Toggle between Newest first and Oldest first to change the sort order. The default is newest first.

Resuming Sessions​

Click on any session in the history list to resume it. This opens a new terminal and reconnects to the previous conversation, so the AI has full context of what was discussed.

Fork a Session​

If you want to branch off from a previous conversation without modifying it, use the Fork action. This creates a new session that starts with the full context of the original, but any new messages go into a separate conversation thread. Forking uses the AI provider's --fork-session flag under the hood.

Forking is useful when a session went in one direction but you want to explore an alternative approach from a specific point.

Continue Last Session​

The Continue Last button at the top of the history panel resumes the most recent session with a single click. This uses the --continue flag to pick up the conversation where it ended.

Auto-Resume on Restart​

Experimental

This feature is experimental and may not restore all sessions perfectly. Sessions that were in the middle of a long-running operation may need to be manually restarted.

When enabled, Omniscribe automatically resumes any sessions that were active when you quit the app. Toggle this in Settings > Sessions > Auto-Resume on Restart.

This is useful if you restart Omniscribe frequently and want to avoid manually relaunching your sessions each time.