What does the new Claude Code integration actually do?

[Glen Mailer]

After updating recently I'm now getting prompts to try out the claude code integration - is there any information anywhere on what this actually does?

[George Nachman]

Here are some draft docs on it. It’s still under development and feedback is welcome. It works for me but there are as many workflows as there are developers, and there’s probably a lot more I could do to make it useful for others.

Installing

Install it from the iTerm2 menu via Install Claude Code Integration. The wizard walks you through:

- Enabling iTerm2's Python API

- Registering a small status hook in ~/.claude/settings.json

- Showing the toolbelt with the Session Status tool

- Installing the Claude Code Workgroup

- Optionally adding triggers to the profiles you use with claude, so the workgroup is entered automatically when Claude starts and exited when it stops

Everything the installer adds is removable from the same menu, and once installed it's all just regular user data you can edit in Settings.

Session Status

A new toolbelt panel that gives you an at-a-glance view of every Claude session in any tab or window:

- Working (orange dot), waiting for permission or input (blue dot), or idle (green dot)

- Sessions that need your attention bubble to the top

- Each row carries a one-line detail: the file being edited, the bash command requested, the search being run, or the last assistant message when Claude stops

- Click a row to jump straight to that session

This makes it practical to run several Claudes in parallel and triage them visually rather than cycling through tabs.

The Claude Code Workgroup

A workgroup is iTerm2's name for a related cluster of sessions that share a toolbar and can be swapped in place of one another. The bundled Claude Code Workgroup gives you three peers behind

the same pane:

- Main: where claude runs

- Diff: a git difftool view with a per-file selector, a configurable git base ref, and prev/next navigation

- Code Review: a Claude session that reviews your changes against a configurable prompt; you can save multiple prompts and pick between them

Switch between peers with one click. The result feels less like driving a CLI and more like a small IDE pane.

Clippings

When Claude finishes a review, it can post findings back into iTerm2 as Clippings in a right-gutter panel via it2 session add-clipping. Review comments live next to the code you're working on

instead of scrolling away in the chat transcript.

If you change your mind

- The integration is purely additive; it doesn't change how claude runs

- The uninstaller cleanly removes the hook, the workgroup, and the per-profile triggers

- It asks before disabling the Python API, in case you're using it for other things

The easiest way to decide whether it's for you is to install it on a profile, open a few claude sessions, and watch the Session Status panel for an afternoon.

On May 8, 2026 at 6:29:19 AM, Glen Mailer <glen...@gmail.com> wrote:

After updating recently I'm now getting prompts to try out the claude code integration - is there any information anywhere on what this actually does?

--
You received this message because you are subscribed to the Google Groups "iterm2-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to iterm2-discus...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/iterm2-discuss/763fded9-deaa-4c41-ba8e-8459fe55db21n%40googlegroups.com.