Skip to content

Add iTerm2 support via Python AutoLaunch script#3

Merged
MisterBrookT merged 1 commit into
mainfrom
claude/repo-improvements-github-trends-qEGbH
Jun 3, 2026
Merged

Add iTerm2 support via Python AutoLaunch script#3
MisterBrookT merged 1 commit into
mainfrom
claude/repo-improvements-github-trends-qEGbH

Conversation

@MisterBrookT
Copy link
Copy Markdown
Collaborator

Summary

Adds native iTerm2 support, expanding Paws to cover the three most popular macOS terminals.

  • iterm2/paws.py β€” ~60-line Python AutoLaunch script using the iTerm2 Python API. Registers three RPC functions: paws_toggle() (Cmd+G spawn-or-focus), paws_picker() (Cmd+Shift+P reopen), paws_help() (Cmd+H open repo). Tab ID persisted to ~/.config/paws/iterm2-tab-id so toggle survives reloads.
  • docs/iterm2-setup.md β€” step-by-step setup guide (copy script, reload in iTerm2, bind 3 keys in Settings β†’ Keys)
  • README / README.zh β€” badge updated to "Kaku | WezTerm | iTerm2", all three paths shown in Install section
  • SKILL.md β€” iTerm2 added as supported terminal, Step 2 split into 2a (Lua) and 2b (Python/iTerm2)

UX comparison

Kaku / WezTerm iTerm2
Setup Add one file to Lua config Copy script + bind 3 keys in GUI
Toggle behavior Identical Identical
Auto-reload WezTerm: yes; Kaku: CMD+Shift+R Script auto-starts at launch

Why this matters for reach

iTerm2 is the most-installed macOS terminal. Paws now covers Kaku + WezTerm (~15k stars) + iTerm2 β€” together that's the majority of macOS developer terminal users.


Generated by Claude Code

- iterm2/paws.py: ~60-line Python script using the iTerm2 Python API;
  registers paws_toggle() (Cmd+G), paws_picker() (Cmd+Shift+P),
  paws_help() (Cmd+H) as RPC functions. Tab state persisted to
  ~/.config/paws/iterm2-tab-id so toggle survives config reloads.
- docs/iterm2-setup.md: step-by-step setup guide (copy script,
  reload, bind 3 keys in Settings β†’ Keys β†’ Key Bindings)
- README/README.zh: badge updated to "Kaku | WezTerm | iTerm2";
  install section shows all three terminal paths
- SKILL.md: preconditions include iTerm2; Step 2 split into 2a (Lua)
  and 2b (Python script for iTerm2)

iTerm2 requires one extra step vs WezTerm (manual key binding in GUI)
but runtime behavior is identical once set up.

https://claude.ai/code/session_017EVNoc8mhrztPNg2S1QEA3
@MisterBrookT MisterBrookT force-pushed the claude/repo-improvements-github-trends-qEGbH branch from 485d20c to 9ebb2f8 Compare June 3, 2026 09:34
@MisterBrookT MisterBrookT merged commit cedd30e into main Jun 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants