it2 session get-buffer
Get buffer contents of a session
Synopsis
it2 session get-buffer [<session-id>] [flags]
Description
Get buffer contents of a session including scrollback history.
Examples
# Get current session buffer
$ it2 session get-buffer
# Get specific session buffer
$ it2 session get-buffer SESSION123
# Get last 100 lines only
$ it2 session get-buffer --lines 100
$ it2 session get-buffer --last 100
# Quick tail-like usage (last 20 lines)
$ it2 session get-buffer --last 20
# Include color/formatting information
$ it2 session get-buffer --color
# Save session output to file
$ it2 session get-buffer > session-output.txt
# Get JSON format with metadata
$ it2 session get-buffer --format json
# Search through buffer contents
$ it2 session get-buffer | grep "ERROR"
# Archive session output daily
$ it2 session get-buffer SESSION123 > "logs/$(date +%Y%m%d)-session.log"
Options
-
--color - Include ANSI color codes in output
-
--escaped - Show escape sequences as visible characters (like cat -v)
-
--format(default "table") - Output format (table|json|yaml|text)
-
--include-empty-lines - Include trailing empty/blank lines in output (default: strip them)
-
--last(default 0) - Number of last lines to retrieve (alias for --lines)
-
--lines(default 10000) - Number of lines to retrieve
-
--scrollback - Include scrollback history
-
--timeout(default "5s") - Command timeout
-
--url(default "ws://localhost:1912") - iTerm2 WebSocket URL
See Also
- it2 session - Manage iTerm2 sessions
- it2 session autorespond - Monitor and automatically respond to session prompts
- it2 session badge - Manage session badges
- it2 session close - Close one or more sessions
- it2 session copy - Copy current selection to clipboard
- it2 session current - Show the current session ID
- it2 session focus - Focus/activate a session
- it2 session focused - Get the currently focused session ID
- it2 session get-info - Get comprehensive session information
- it2 session get-pid - Get the process ID (PID) of the shell in a session
- it2 session get-screen - Get current screen contents of a session
- it2 session has-shell-integration - Check if shell integration is enabled for a session
- it2 session list - List all iTerm2 sessions
- it2 session lookup - Look up session relationships and hierarchy
- it2 session monitor - Monitor session events in real-time
- it2 session move - Move a session to be a split pane next to another session
- it2 session paste - Paste clipboard content to session
- it2 session process - Process inspection for sessions
- it2 session profile - Manage session profile properties
- it2 session prompt - Get shell prompt metadata for a session
- it2 session resize - Resize a pane in a split layout
- it2 session restart - Restart a session
- it2 session select - Select text in a session
- it2 session send-key - Send a special key to a session
- it2 session send-text - Send text to a session as if typed
- it2 session split - Split a session pane
- it2 session splits - Show split pane layout (moved to 'tab splits')
- it2 session tail - Continuously monitor session output (like tail -f)
- it2 session title - Manage session titles
- it2 session variable - Manage session variables
- it2 session watch - Watch sessions and provide status overview