Warp documentation
  • 🚀Getting Started
    • Quickstart Guide
    • What is Warp?
    • Migrate to Warp
    • Using Warp with [zsh|bash|fish|pwsh]
    • Privacy
    • Refer a Friend & Earn Rewards
    • Warp Preview & Alpha Program
    • Changelog
  • 🎨Appearance
    • Themes
    • Custom Themes
    • Prompt
    • Input Position
    • Text, Fonts, & Cursor
    • Size, Opacity, & Blurring
    • Pane Dimming & Focus
    • Blocks Behavior
    • Tabs Behavior
    • App Icons
  • 📕Features
    • Warp AI
      • Active AI
      • Agent Mode
      • Generate
      • Model Context Protocol
      • Voice
      • Rules
    • Command Palette
    • Warp Drive
      • Notebooks
      • Workflows
      • Prompts
      • Environment Variables
      • Warp Drive on the Web
    • Teams
    • Session Sharing
    • Blocks
      • Block Basics
      • Block Actions
      • Block Sharing
      • Block Filtering
      • Background Blocks
      • Sticky Command Header
    • Modern Text Editing
      • Alias Expansion
      • Command Inspector
      • Syntax & Error Highlighting
      • Vim Keybindings
    • Command Entry
      • Command Corrections
      • Command Search
      • Command History
      • Synchronized Inputs
      • YAML Workflows
    • Command Completions
      • Completions
      • Autosuggestions
    • Session Management
      • Launch Configurations
      • Session Navigation
      • Session Restoration
    • Window Management
      • Global Hotkey
      • Tabs
      • Split Panes
    • Warpify
      • Subshells
      • SSH
    • Accessibility
    • Find
    • Files, Links, & Scripts
    • Markdown Viewer
    • Working Directory
    • Smart-Select
    • Full-screen Apps
    • Keyboard Shortcuts
    • Notifications & Audible Bell
    • Settings Sync (Beta)
    • Quit Warning
    • Integrations
    • URI Scheme
    • Network Log
    • Secret Redaction
    • Linux
  • 📊How Does Warp Compare?
    • Performance
    • Terminal features
  • ❓Help
    • Sending Feedback & Logs
    • Plans, Subscriptions & Pricing
    • Updating Warp
    • Using Warp Offline
    • Logging out & Uninstalling
    • Known Issues
    • Troubleshooting Login Issues
    • Open Source Licenses
Powered by GitBook
On this page
  • What is it
  • How to access Session Restoration
  • How Session Restoration works

Was this helpful?

  1. Features
  2. Session Management

Session Restoration

The Session Restoration feature enables Warp to restore your session history, specifically windows, tabs, and panes, along with the last few Blocks in each pane.

PreviousSession NavigationNextWindow Management

Last updated 2 months ago

Was this helpful?

What is it

Session restoration allows you to quickly pick up where you left off in your previous terminal session.

How to access Session Restoration

  • Session Restoration comes enabled by default in Warp.

On Linux, opening windows at a specific position is not supported in Wayland.

  • You can disable Session Restoration by going to Settings > Features, then toggling off Restore windows, tabs, and panes on startup.

Toggling off Session Restoration will not clear the ; however, Warp will stop recording new output.

How Session Restoration works

Session Restoration database

Warp saves the data from your previous session's windows, tabs, and panes to a SQLite database on your computer, and every time you quit the app, this data is overwritten by your latest session. You can open the database directly and inspect its full contents like so:

sqlite3 "$HOME/Library/Application Support/dev.warp.Warp-Stable/warp.sqlite"
sqlite3 $env:LOCALAPPDATA\warp\Warp\data\warp.sqlite
sqlite3 "${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/warp.sqlite"

How to clear the Session Restoration database

Sometimes, you may want to prevent a sensitive Block from being saved on your computer, or you may want to clear blocks from a machine entirely.

This interferes with the running session's ability to save content and may require you close Warp before running the database removal commands.

There are two ways to do this:

  • Clear the blocks from your running Warp session with CMD-K.

  • Delete the SQLite file entirely with the following command:

rm -f "$HOME/Library/Application Support/dev.warp.Warp-Stable/warp.sqlite"
  • Clear the blocks from your running Warp session with CTRL-SHIFT-K.

  • Delete the SQLite file entirely with the following command:

Remove-Item -Force $env:LOCALAPPDATA\warp\Warp\data\warp.sqlite
  • Clear the blocks from your running Warp session with CTRL-SHIFT-K.

  • Delete the SQLite file entirely with the following command:

rm -f "${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/warp.sqlite"
📕
SQLite database
Session Restoration Demo