Daemon & Sessions

Overview

ori-term keeps your shell sessions running in a background process, separate from the window. Close the window -- your sessions keep running. Reopen ori-term -- pick up where you left off. This is similar to tmux's client-server model, but built right into the terminal.

Auto-Start

The background process starts automatically when you launch ori-term. If one is already running, the window connects to it instead of starting a new one. No manual management needed for normal use.

For sandboxed environments where a background process is not possible, ori-term falls back to single-process mode automatically.

Session Persistence

Your workspace is auto-saved every 30 seconds:

Session data is written safely to prevent corruption from unexpected shutdowns.

Crash Recovery

If the window or background process terminates unexpectedly, ori-term detects it on next launch and offers to restore your session. Your shell processes continue running -- only the window connection was lost.

Multi-Client

Multiple windows can connect to the same background process simultaneously. All windows see the same session state. Changes made in one window are reflected in all others.

Managing the Daemon

For advanced use cases, the background process supports command-line flags:

ori-term --daemon       # Start background process manually
ori-term --stop         # Stop the running background process
ori-term --persist      # Keep sessions alive after last window closes