[Bug] MacOS Zcode does not inherit path
Open
Nobody has claimed this yet.
priority: P2
status: 待评估
type: Bug
- Dominant language
- No language data
- Stars
- 22
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Description
提交前确认 · Pre-submission checklist
- 我已搜索过现有 issue，确认这不是重复 / I searched existing issues and confirmed this isn't a duplicate.
- 我已阅读 CONTRIBUTING.md / I've read CONTRIBUTING.md.
问题类别 · Category
工具调用 / MCP · Tool use / MCP
涉及的 Agent 框架 · Agent framework
ZCode Agent（自研）
严重程度 · Severity
阻塞使用 · Blocking (无法使用核心功能 / core function unusable)
复现频率 · Reproducibility
必现 · Always
问题描述 · Description
The agent does not properly set up the path in MacOS. I have a .zshenv file but the app does not read it.
复现步骤 · Steps to reproduce
- launch zcode from the macos dock
- try to use any tool, like git
期望表现 · Expected behavior
use the tools
实际表现 · Actual behavior
fail to find the tools due to an improperly configured PATH
ZCode 版本 · ZCode version
v3.3.6
设备 / 系统 / 浏览器 · Device / OS / Browser
MacOS 26.5.2
截图 / 录屏 / 日志 · Screenshots / Recordings / Logs
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
The report identifies launching ZCode from the macOS Dock and the user's .zshenv as the relevant entry points. Start by reproducing the failure with git or another tool, then inspect how the Dock-launched app initializes PATH and reads shell environment settings. Done means tools launched through ZCode resolve correctly on macOS.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- git, macos, zsh
- Domain
- desktop, tooling
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 38/100