Skip to content

fix(shell): ensure standard PATH directories on macOS#29093

Open
divitkashyap wants to merge 1 commit into
anomalyco:devfrom
divitkashyap:fix/shell-env-path-17792
Open

fix(shell): ensure standard PATH directories on macOS#29093
divitkashyap wants to merge 1 commit into
anomalyco:devfrom
divitkashyap:fix/shell-env-path-17792

Conversation

@divitkashyap
Copy link
Copy Markdown

@divitkashyap divitkashyap commented May 24, 2026

Issue for this PR

Closes #17792

Type of change

  • Bug fix

What does this PR do?

On macOS, the shell tool can launch with an incomplete `PATH` that omits `/opt/homebrew/bin` (and sometimes `/usr/local/bin`). When that happens, calls like `git` or `gh` from the agent fail with `env: sh: No such file or directory`, even though those binaries are on the user's interactive `PATH`.

Prepend the standard macOS directories (`/opt/homebrew/bin`, `/usr/local/bin`, `/usr/bin`, `/bin`) to the shell env when they are missing. darwin-only; no-op when paths are already present.

This is a partial mitigation for #17792 — it doesn't fully unify with the user's interactive shell, but it removes the most common failure mode (Homebrew binaries unreachable from the agent). Happy for a maintainer to reopen the broader issue after merge if a full shell-init unification is still wanted.

How did you verify your code works?

Logic check against the existing `shellEnv` builder in `packages/opencode/src/tool/shell.ts` — the change only appends to the env that's already constructed from `process.env` + plugin extras.

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

Supersedes #21347 (auto-closed by cleanup); bash tool was renamed to `shell.ts` so the fix has been re-targeted.

On macOS, the shell tool may launch with an incomplete PATH that does
not include /opt/homebrew/bin, causing common commands like git and gh
to fail with 'env: sh: No such file or directory'.

Prepend the standard macOS PATH directories (/opt/homebrew/bin,
/usr/local/bin, /usr/bin, /bin) to the shell environment when they are
missing, matching what a user's interactive shell would see.

Refs anomalyco#17792
@github-actions
Copy link
Copy Markdown
Contributor

Thanks for your contribution!

This PR doesn't have a linked issue. All PRs must reference an existing issue.

Please:

  1. Open an issue describing the bug/feature (if one doesn't exist)
  2. Add Fixes #<number> or Closes #<number> to this PR description

See CONTRIBUTING.md for details.

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.

[FEATURE]: Unify shell initialization behavior between user shell and agent bash tool

1 participant