Get macfor Pro

Pro plugin

iTerm2

Collects iTerm2 shell-integration histories, profiles and SSH configuration, saved session state, automation scripts, and preferences

devtools.iterm2PromacOS 10.15+v1.0.0devtoolsusercommand-history

Run this plugin

Trigger collection for iTerm2 on its own with the --plugin flag, or include it in a wider sweep by category.

# Just this plugin
macfor-pro collect --plugin devtools.iterm2 --output ./evidence.zip

# Dry run — list what would be collected
macfor-pro collect --plugin devtools.iterm2 --dry-run

Compatibility

  • macOS 10.15+

Licensing: ships in the macfor-pro binary. See Community vs Pro.

Artifacts (8 collected)

Each row corresponds to an entry in the plugin's artifacts.yaml manifest. Optionalartifacts are often absent, and their absence isn't recorded as an error. Plannedartifacts are documented locations the plugin doesn't collect yet. Where a path shows a version range, macfor only tries it when the source's macOS or application version is in that range.

command history

ArtifactFormatPathNotes
Command History
iterm2_command_historyOptional
json~/.iterm2/CommandHistory.json—
Directory History
iterm2_directory_historyOptional
json~/.iterm2/DirectoryHistory.json—

logs

ArtifactFormatPathNotes
Remote Hosts
iterm2_remote_hostsOptional
json~/.iterm2/RemoteHosts.json—

config

ArtifactFormatPathNotes
Profiles
iterm2_profiles
binary_plist~/Library/Preferences/com.googlecode.iterm2.plist—
Automation Scripts
iterm2_scriptsOptional
directory~/Library/Application Support/iTerm2/Scripts—
Preferences
iterm2_preferencesOptional
binary_plist~/Library/Preferences/com.googlecode.iterm2.plist—

session

ArtifactFormatPathNotes
Saved State
iterm2_saved_stateOptional
directory~/Library/Application Support/iTerm2/SavedState—

metadata

ArtifactFormatPathNotes
Raw Files
iterm2_rawOptionalOpt-in
directory~/.iterm2—