it2 text get-buffer

Get buffer contents (moved to 'session get-buffer')

Synopsis

it2 text get-buffer [<session-id>] [flags]

Description

This command has moved to 'session get-buffer'. Please use 'it2 session get-buffer' instead.

Options

--allow-self

Allow reading buffer from the same session (disabled by default for safety)

--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

--wait-stable

Wait until buffer is stable (uses --wait-stable-tolerance for timing)

--wait-stable-max-wait (default "10s")

Maximum total time to wait for stability (default: 10s). 0 for no limit

--wait-stable-tolerance (default "normal")

Stability tolerance level: low (500ms), normal (2s), high (5s)

See Also

  • it2 text - Text and buffer operations in iTerm2

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

# Wait until buffer stabilizes before getting (default 2s)
$ it2 session get-buffer --wait-stable

# Wait with quick detection
$ it2 session get-buffer --wait-stable --wait-stable-tolerance=low

# 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"

# Wait for command to complete, then capture output
$ it2 session send-text SESSION123 "long-running-command"
$ it2 session get-buffer SESSION123 --wait-stable --lines 50