External Git Client

  • Desktop app
  • All plans

What it does

Hands a checkout to the Git client you prefer (for live review, history rewriting or conflicts) in one click: Open in external Git client opens that exact repository or worktree, on its branch. You choose the client once, from a short list of presets or with your own command or link. With no client set, the entries are hidden.

Where to find it

  • Settings > Git > External Git client: the client for every project (synced with your account).
  • Project settings > Git > External Git client: this project's own client, instead of the global one.
  • Once a client is set, Open in external Git client (or Open in GitHub Desktop, Open in Sublime Merge...) appears in:
    • Changes > Worktrees: right-click a row (or its menu), on that checkout;
    • the Changes tab header, next to the branch: the checkout the tab shows right now;
    • the agent card's right-click menu: the agent's worktree, or the project's checkout.

How to use it

  1. Settings > Git > External Git client: pick a preset (GitHub Desktop, Sublime Merge, Tower, Fork, Sourcetree, gitg, depending on your OS) or Custom command or link.
  2. The field shows the exact command it will run on the current project. A preset applies as soon as you pick it, a custom command when you leave the field, if it is valid.
  3. Use Open in external Git client from one of the places above. The first time (and each time the command changes), AgentsRoom shows the exact command or link and asks you to confirm it on this computer.

A custom value is either:

  • a command, run without a shell: spaces separate arguments, "double" or 'single' quotes group words, nothing else is interpreted (no pipes, no variables). Example: my-git-client open "{worktreePath}". On Windows, give the client's .exe (a .cmd or .bat script cannot run without a shell);
  • a link starting with scheme://, opened by the app that registered it. Example: my-git-client://open?path={worktreePath|urlencoded}.

Placeholders: {repoRoot} (the main checkout of the repository), {worktreePath} (the checkout to open), {branch}, {agentId} (the agent, when there is one). Add |urlencoded to encode a value inside a link.

Settings

  • externalGitClient (global, Settings > Git > External Git client, empty by default = off, synced with your account): the command or link template.
  • externalGitClient (project override, Project settings > Git > External Git client): same format; empty means the project uses the global one.
  • externalGitClientApproved (read-only, this computer only): the commands you already confirmed. Only the confirmation window writes it.

Agent tools (MCP)

  • settings_get / settings_set with key externalGitClient (scope global or project). A command set by an agent is still shown to you for confirmation before it first runs.

Providers

All providers, no difference: it opens a git checkout, not an agent session.

Mobile

Not on the mobile companion: it opens an application on the computer's screen, which is useless from the phone.

Limits

  • The client must be installed, with its command line tool when the preset uses one (smerge, gittower, stree, gitg). On macOS, AgentsRoom finds tools installed with Homebrew even when it is started from the Dock.
  • Names with spaces or accents and any branch name are passed as one argument each: they can never add an argument or run another command.
  • Links starting with file:, javascript: or data: are refused.

Common questions

  • Can AgentsRoom open my repository in GitHub Desktop / Sublime Merge / Tower / Fork? Yes: Settings > Git > External Git client, pick it in the list.
  • My Git client is not in the list. Choose Custom command or link and write its command (client "{worktreePath}") or its URL scheme.
  • Can a project use another client? Yes: Project settings > Git > External Git client.
  • Why does it ask me to confirm the command? So that a command synced from your account or set by an agent never runs without you seeing it. You are asked once per command on each computer.
  • "Could not start the Git client": the command was not found. Install the client's command line tool or write the full path of its program.
  • I don't see "Open in external Git client". No client is set: the entries only appear once Settings > Git > External Git client (or the project's one) is filled.