it2 artifact get

Get an artifact's contents

Synopsis

it2 artifact get <session-id> <artifact-path> [flags]

Description

Retrieve and display an artifact's contents.

The artifact-path can be:

  • Relative path: buffer-snapshot/2025-10-10T14-30-00Z.txt
  • Just filename: 2025-10-10T14-30-00Z.txt (searches all categories)

Examples:

Get specific buffer snapshot

$ it2 artifact get sess_abc123 buffer-snapshot/2025-10-10T14-30-00Z.txt

Save to file

$ it2 artifact get sess_abc123 file/output.txt --output copy.txt

Search by filename

$ it2 artifact get sess_abc123 output.txt

Options

-o, --output
Output file (default: stdout)

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