it2 variable set

Set value of a variable

Synopsis

it2 variable set <scope> <name> <value> [identifier]

Description

Set the value of a variable in a specific scope.

Scopes:
app - Application-wide variables
session - Session-specific variables (requires session-id)
tab - Tab-specific variables (requires tab-id)
window - Window-specific variables (requires window-id)

Note: Variable names must begin with "user." for user-defined variables.

Examples

# Set app-level variable
$ it2 variable set app user.my_var "hello world"
# Set session variable
$ it2 variable set session user.env "production" abc123
# Set current session variable
$ it2 variable set session user.status "active" $ITERM_SESSION_ID
# Set tab variable
$ it2 variable set tab user.tab_name "build" tab-123
# Set window variable
$ it2 variable set window user.window_type "dev" window-123
# Set variable with command output
$ it2 variable set app user.hostname "$(hostname)"
# Set timestamp
$ it2 variable set session user.start_time "$(date +%s)" $ITERM_SESSION_ID

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