it2 session profile

Manage session profile properties

Description

Manage profile properties for a specific session.

Session profile properties are per-session overrides of the profile template.
Changes only affect the specified session, not the underlying profile.

Common profile properties:

  • Badge Text: Session badge text
  • Title: Session title (shown in tab/window)
  • Name: Session name
  • Background Color: Background color override
  • Foreground Color: Text color override

Examples:
it2 session profile get "Badge Text"
it2 session profile set "Badge Text" "PROD"
it2 session profile list
it2 session profile reset "Badge Text"

Commands

Options inherited from parent commands

--format (default "text")

Output format (text, json, yaml) - affects how command results are displayed

--timeout

Timeout for API operations - how long to wait for iTerm2 to respond

--url

WebSocket URL for iTerm2 API - typically ws://localhost:1912 for local iTerm2

See Also