it2 artifact
Manage session artifacts and attachments
Description
Commands for attaching, managing, and retrieving artifacts associated with iTerm2 sessions.
Artifacts are categorized data attached to sessions including:
- Buffer snapshots and diffs
- Files produced during session
- Events received by session
- Notes and annotations
- Error logs
Artifacts are stored in ~/.it2/sessions/
Commands
- it2 artifact add - Add an artifact to a session
- it2 artifact append - Append data to a JSONL artifact
- it2 artifact delete - Delete an artifact
- it2 artifact diff - Show diff between two artifacts
- it2 artifact get - Get an artifact's contents
- it2 artifact list - List all artifacts for a session
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
- it2 - iTerm2 API Command-Line Interface
Examples
# Add a buffer snapshot
it2 artifact add sess_abc123 buffer-snapshot
# Attach a file produced during session
it2 artifact add sess_abc123 file --path output.txt
# Add a note to session
it2 artifact add sess_abc123 note --data "Started debugging at 14:30"
# List all artifacts for a session
it2 artifact list sess_abc123
# Get artifact details
it2 artifact get sess_abc123 buffer-snapshot/2025-10-10T14:30:00Z.txt