it2 session tail

Continuously monitor session output (like tail -f)

Synopsis

it2 session tail [<session-id>] [flags]

Description

Stream session output in real-time, similar to 'tail -f' for log files.

This command polls the session buffer at regular intervals and displays new content
as it appears. Useful for monitoring long-running commands or watching session output.

Examples

# Tail current session output
$ it2 session tail
# Tail specific session
$ it2 session tail abc123
# Tail with faster polling (every 500ms)
$ it2 session tail --interval 500ms
# Tail with initial context (show last 20 lines first)
$ it2 session tail --lines 20
# Tail and filter for errors
$ it2 session tail --grep error
# Tail and exclude debug messages
$ it2 session tail --grep-v DEBUG
# Case-insensitive pattern matching
$ it2 session tail --grep error --ignore-case
# Show only command output (hide prompts)
$ it2 session tail --output-only
# Tail multiple sessions side-by-side (in different terminals)
$ it2 session tail sess1 &
$ it2 session tail sess2 &
# Monitor build output with faster polling
$ it2 session tail build-session --interval 500ms --grep "✓\|✗"

Options

--color

Preserve ANSI color codes
-f, --follow (default true)
Follow output (disable to just show last N lines)

--format (default "table")

Output format (table|json|yaml|text)

--grep

Only show lines matching this pattern

--grep-v

Only show lines NOT matching this pattern
-i, --ignore-case
Case-insensitive pattern matching

--interval (default "1s")

Polling interval for new content

--lines (default 10)

Number of initial lines to show (0 for none)

--output-only

Hide command echoes and prompts, show only output

--timeout (default "5s")

Command timeout

--url (default "ws://localhost:1912")

iTerm2 WebSocket URL

See Also