dsh-apple-mode

Apple Mode

DeepSeek Harness 的 Apple Mode：一个声明 26 个 Xcode MCP 工具（mcpbridge）、Apple 平台技能以及 Xcode Intelligence 风格角色设定的代理预设。该预设需要 DSH 0.2.0+；DSH 0.1.x 使用 install.sh。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:jihongboo/dsh-apple-mode#71e4e64c68726dc447aadee5b9fe9e9b31161f19

兼容性与来源证明

Apple Mode 以 dsh-apple-mode 发布，当前版本为 1.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: any
发布来源: github
Registry 更新时间: 2026/10/12

版本

1.1.1stable

2026/10/12

1.1.0stable

2026/10/12

README

dsh-apple-mode

English · 简体中文

Xcode AI integration mode for DeepSeek Harness (dsh) — an agent preset + installer that gives your DSH sessions the full Xcode AI stack:

26 Xcode MCP tools (mcp__xcode__*) via Apple's official mcpbridge
Xcode Intelligence–style persona (Swift-first, tool-assisted, explain-vs-change classification) adapted from the IDEIntelligenceChat prompt templates
10 Apple platform skills (SwiftUI, App Intents, security hardening, bounds safety, …) generated locally from your own Xcode

📌 dsh-plugin topic repo. DeepSeek Harness is in developer preview — pin an exact dsh version for your automation.

Why a preset (mode) instead of a global MCP wiring?

The three capabilities map onto three different DSH mechanisms:

Layer	Capability	DSH mechanism
Execute	26 `mcp__xcode__*` tools	`dsh-mcp-client` (mounted inside the preset)
Knowledge	10 Apple skills	`dsh-skill-filesystem` (global, lazy-loaded)
Behavior	Xcode Intelligence persona	agent preset (this repo)

Wiring the MCP server globally would put ~26 large tool schemas (~6k+ tokens/request) into every session. Mounting it inside a preset keeps the cost only in sessions that opt in — pick Apple Mode when creating a session, and you get the whole stack; other sessions stay lean.

Requirements

macOS
DeepSeek Harness 0.2.0+ for the plugin path (the desktop app ships 0.2.x). DSH 0.1.x uses the legacy on-disk preset through install.sh — see Version compatibility.
Xcode 26+ (contains mcpbridge and xcrun agent skills export). To use the MCP tools, Xcode must be running with the target project open, and you must click Allow on the MCP access dialog Xcode shows (see Usage).

Install

DSH 0.2.0+ (desktop app / current) — recommended

Install the plugin with the plugin manager. Its bundle patch declares the Apple Mode agent preset:

dsh plugin --profile web add "github:jihongboo/dsh-apple-mode"

Pin a released version by appending a tag — recommended for reproducibility, since an install without a tag tracks the default branch:

dsh plugin --profile web add "github:jihongboo/dsh-apple-mode#v1.1.1"

(In the desktop app: Settings → Plugins → install from GitHub.) Restart DSH, then pick Apple Mode when creating a session.

About the plugin manager's pnpm warning. This package is configuration-only — no scripts, no dependencies, no build step (see package.json). If a registry page warns that pnpm ≥ 10 refuses to run git-dependency prepare scripts and suggests adding allowBuilds to pnpm-workspace.yaml, you can safely skip it: there is nothing to build or execute, and granting it would only widen the authorization surface for no benefit. Publishing to npm (see docs/publishing.md) removes the warning entirely.

Then generate the Apple skills locally — the plugin deliberately does not redistribute them:

git clone https://github.com/jihongboo/dsh-apple-mode.git
cd dsh-apple-mode
./install.sh --skills-only

DSH 0.1.x — legacy on-disk preset

git clone https://github.com/jihongboo/dsh-apple-mode.git
cd dsh-apple-mode
./install.sh

install.sh then does three things:

Detects your Xcode installs and lets you choose which one provides mcpbridge (see below).
Installs the on-disk preset → ~/.dsh/.agent-presets/apple/ (existing copy is backed up).
Generates the 10 Xcode AI skills on your machine via xcrun agent skills export into ~/.agents/skills/.

Why no vendored skills? The skills are Apple-authored guidance. Generating them from your own Xcode at install time avoids redistributing Apple content — the repo ships only our own code, config, and docs.

Version compatibility

DSH 0.2 renamed and reworked agent presets: a preset is now a @deepseek-ai/dsh-agent-preset row declared by a bundle patch, and the registry no longer scans directories.

DSH	Preset mechanism	How to get Apple Mode here
0.2.0+ (desktop)	`@deepseek-ai/dsh-agent-preset` rows from a bundle patch	`dsh plugin --profile web add "github:jihongboo/dsh-apple-mode"`
0.1.x (older `npx`/brew)	on-disk directories under `~/.dsh/.agent-presets/<id>/`	`./install.sh`

Skills are discovered from ~/.agents/skills on both versions, so ./install.sh --skills-only works everywhere.

Choosing an Xcode (multiple installs)

If you have several Xcode versions (e.g. Xcode.app, Xcode-beta.app, Xcode-26.2.app), mcpbridge lives in each one's Contents/Developer/usr/bin — and only in Xcode 26+.

DSH 0.2.0+: the preset's MCP row runs xcrun mcpbridge, so the Xcode comes from xcode-select:

sudo xcode-select -s /Applications/Xcode-26.2.app/Contents/Developer   # switch globally
DEVELOPER_DIR=/Applications/Xcode-beta.app/Contents/Developer dsh web  # or per launch

To drive a specific running Xcode instance, add env: { MCP_XCODE_PID: '<pid>' } to the mcp-xcode row inside the preset (edit cordis.patch.yml in this repo, or override the preset-apple row from your profile patch).

DSH 0.1.x: install.sh scans /Applications for every install that provides mcpbridge and prompts you to pick:

Found Xcode installs providing mcpbridge:
  1) /Applications/Xcode-beta.app/Contents/Developer  (xcode-select default)
  2) /Applications/Xcode.app/Contents/Developer
Choose (1-2, default 1):

Default = the Xcode selected by xcode-select → the preset uses command: xcrun mcpbridge (portable; follows future xcode-select changes).
Pick another → the chosen …/Contents/Developer/usr/bin/mcpbridge is baked into the installed preset as an absolute path.
Non-interactive: ./install.sh --xcode /Applications/Xcode.app (or --xcode …/Contents/Developer); ./install.sh --list-xcodes prints the candidates.
Switch at runtime without reinstalling: ./install.sh --runtime-selectable installs bin/mcpbridge as the command; set DSH_XCODE_DEVELOPER_DIR=/Applications/…/Contents/Developer when launching dsh to switch. (Resolution: DSH_XCODE_DEVELOPER_DIR → xcrun → newest /Applications/Xcode*.app.)

To change the choice later: re-run ./install.sh, edit the mcp-xcode row in ~/.dsh/.agent-presets/apple/agent.cordis.yml, or use the runtime env var above.

Alternative: global MCP wiring (MCP in every session)

The preset keeps the ~26 tool schemas scoped to Apple Mode sessions. To get the Xcode MCP tools in every session instead, insert the client row in your profile patch (~/.dsh/profiles/<profile>/cordis.patch.yml):

- insert:
    - id: mcp-xcode
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: xcode
        transport: stdio
        command: xcrun
        args: ['mcpbridge']
        toolCallTimeoutMs: 120000

Use one path, not both: two live instances with serverName: xcode collide and the later one fails to load. See docs/global-mcp.md.

Usage

Restart dsh (or just open a new session — the preset can only be selected on a blank session).
Pick Apple Mode as the agent preset when creating the session.
The session now has:
- mcp__xcode__* tools — operate the open Xcode workspace: XcodeRead/Write/Update/MV/RM, XcodeGlob/Grep/LS, UpdateTargetBuildSetting/UpdateFileCompilerFlags, XcodeListNavigatorIssues, scheme/run-destination/test-plan switching, XcodeNewTarget, StringCatalogRead/Edit, …
- All Apple platform skills (lazy-loaded on demand).
- An Apple-first, tool-assisted working style.

Before using the mcp__xcode__* tools:

Xcode must be running with the project/workspace you want to work on opened in it.

On first connection, Xcode shows an MCP access dialog — click Allow (允许). Until you do, tool calls will be rejected.

Build/run/test still happen from the terminal (xcodebuild, pipe through xcsift for structured output); the MCP toolset covers project surgery, build settings, diagnostics, destinations, and localization.

What you get

MCP tools (26, namespaced `mcpxcode*`)

Group	Tools
Project I/O	`XcodeRead` `XcodeWrite` `XcodeUpdate` `XcodeMV` `XcodeRM` `XcodeMakeDir`
Search	`XcodeGlob` `XcodeGrep` `XcodeLS`
Targets & settings	`XcodeNewTarget` `XcodeListTemplates` `XcodeListTargets` `UpdateTargetBuildSetting` `UpdateFileCompilerFlags`
Scheme / destination / tests	`XcodeListSchemes` `XcodeSwitchScheme` `XcodeListRunDestinations` `XcodeSwitchRunDestination` `XcodeListTestPlans` `XcodeSwitchTestPlan`
Diagnostics	`XcodeListNavigatorIssues` `XcodeRefreshCodeIssuesInFile`
Localization	`StringCatalogRead` `StringCatalogEdit`
Windows	`XcodeListWindows` `XcodeGetCurrentFile`

Skills (10, generated at install time)

swiftui-specialist · swiftui-whats-new-27 · app-intents-specialist · app-intents-whats-new-27 · audit-xcode-security-settings · adopt-c-bounds-safety · uikit-app-modernization · modernize-tests · device-interaction · building-document-based-swiftui-applications

Repository layout

.
├── presets/apple/            # The agent preset: agent.cordis.yml + preset.yml
├── bin/mcpbridge             # Runtime-selectable mcpbridge launcher (--runtime-selectable)
├── cordis.patch.yml          # Bundle patch: declares the Apple Mode preset (DSH 0.2+)
├── package.json              # Bundle manifest (dsh.bundle.patch)
├── docs/
│   ├── XCODE_AI_INTEGRATION.md  # Full integration notes (Chinese)
│   ├── global-mcp.md            # Alternative: wire the MCP server into every session
│   └── publishing.md            # Publishing this package to npm
├── install.sh               # Xcode picker + preset install + local skills generation
├── uninstall.sh
└── LICENSE                  # MIT

Customization

Different Xcode: re-run ./install.sh (picker), ./install.sh --xcode <path> (non-interactive), --runtime-selectable + DSH_XCODE_DEVELOPER_DIR, or add env: { MCP_XCODE_PID: '<pid>' } to the mcp-xcode row to drive a specific running instance. See Choosing an Xcode.
Persona: edit the persona row text in the same file.
Sync skills after Xcode updates: re-run ./install.sh (skills are replaced, preset is backed up).
Keep in sync with upstream standard preset: diff against node_modules/@deepseek-ai/dsh/config/agent-presets/standard/agent.cordis.yml.

Security notes

MCP tool calls do not go through the DSH file sandbox — they go through the tool-approval flow. XcodeUpdate/XcodeWrite modify real Xcode project files (including project.pbxproj).
The preset only activates when you select it; no global config is touched by install.sh.

Contributing

PRs welcome. Open an issue for feature requests. If you publish your own DSH extension, add the dsh-plugin topic for discoverability and consider submitting it to awesome-dsh-plugin.

License

MIT. The Xcode AI skills are generated on your machine from your own Xcode installation and remain subject to Apple's license; the persona prompt style is adapted from Xcode Intelligence templates (behavioral guidance, not Apple source text).

README

dsh-apple-mode

English · 简体中文

Xcode AI integration mode for DeepSeek Harness (dsh) — an agent preset + installer that gives your DSH sessions the full Xcode AI stack:

26 Xcode MCP tools (mcp__xcode__*) via Apple's official mcpbridge
Xcode Intelligence–style persona (Swift-first, tool-assisted, explain-vs-change classification) adapted from the IDEIntelligenceChat prompt templates
10 Apple platform skills (SwiftUI, App Intents, security hardening, bounds safety, …) generated locally from your own Xcode

📌 dsh-plugin topic repo. DeepSeek Harness is in developer preview — pin an exact dsh version for your automation.

Why a preset (mode) instead of a global MCP wiring?

The three capabilities map onto three different DSH mechanisms:

Layer	Capability	DSH mechanism
Execute	26 `mcp__xcode__*` tools	`dsh-mcp-client` (mounted inside the preset)
Knowledge	10 Apple skills	`dsh-skill-filesystem` (global, lazy-loaded)
Behavior	Xcode Intelligence persona	agent preset (this repo)

Requirements

macOS
DeepSeek Harness 0.2.0+ for the plugin path (the desktop app ships 0.2.x). DSH 0.1.x uses the legacy on-disk preset through install.sh — see Version compatibility.
Xcode 26+ (contains mcpbridge and xcrun agent skills export). To use the MCP tools, Xcode must be running with the target project open, and you must click Allow on the MCP access dialog Xcode shows (see Usage).

Install

DSH 0.2.0+ (desktop app / current) — recommended

Install the plugin with the plugin manager. Its bundle patch declares the Apple Mode agent preset:

dsh plugin --profile web add "github:jihongboo/dsh-apple-mode"

Pin a released version by appending a tag — recommended for reproducibility, since an install without a tag tracks the default branch:

dsh plugin --profile web add "github:jihongboo/dsh-apple-mode#v1.1.1"

(In the desktop app: Settings → Plugins → install from GitHub.) Restart DSH, then pick Apple Mode when creating a session.

About the plugin manager's pnpm warning. This package is configuration-only — no scripts, no dependencies, no build step (see package.json). If a registry page warns that pnpm ≥ 10 refuses to run git-dependency prepare scripts and suggests adding allowBuilds to pnpm-workspace.yaml, you can safely skip it: there is nothing to build or execute, and granting it would only widen the authorization surface for no benefit. Publishing to npm (see docs/publishing.md) removes the warning entirely.

Then generate the Apple skills locally — the plugin deliberately does not redistribute them:

git clone https://github.com/jihongboo/dsh-apple-mode.git
cd dsh-apple-mode
./install.sh --skills-only

DSH 0.1.x — legacy on-disk preset

git clone https://github.com/jihongboo/dsh-apple-mode.git
cd dsh-apple-mode
./install.sh

install.sh then does three things:

Detects your Xcode installs and lets you choose which one provides mcpbridge (see below).
Installs the on-disk preset → ~/.dsh/.agent-presets/apple/ (existing copy is backed up).
Generates the 10 Xcode AI skills on your machine via xcrun agent skills export into ~/.agents/skills/.

Why no vendored skills? The skills are Apple-authored guidance. Generating them from your own Xcode at install time avoids redistributing Apple content — the repo ships only our own code, config, and docs.

Version compatibility

DSH 0.2 renamed and reworked agent presets: a preset is now a @deepseek-ai/dsh-agent-preset row declared by a bundle patch, and the registry no longer scans directories.

DSH	Preset mechanism	How to get Apple Mode here
0.2.0+ (desktop)	`@deepseek-ai/dsh-agent-preset` rows from a bundle patch	`dsh plugin --profile web add "github:jihongboo/dsh-apple-mode"`
0.1.x (older `npx`/brew)	on-disk directories under `~/.dsh/.agent-presets/<id>/`	`./install.sh`

Skills are discovered from ~/.agents/skills on both versions, so ./install.sh --skills-only works everywhere.

Choosing an Xcode (multiple installs)

If you have several Xcode versions (e.g. Xcode.app, Xcode-beta.app, Xcode-26.2.app), mcpbridge lives in each one's Contents/Developer/usr/bin — and only in Xcode 26+.

DSH 0.2.0+: the preset's MCP row runs xcrun mcpbridge, so the Xcode comes from xcode-select:

sudo xcode-select -s /Applications/Xcode-26.2.app/Contents/Developer   # switch globally
DEVELOPER_DIR=/Applications/Xcode-beta.app/Contents/Developer dsh web  # or per launch

DSH 0.1.x: install.sh scans /Applications for every install that provides mcpbridge and prompts you to pick:

Found Xcode installs providing mcpbridge:
  1) /Applications/Xcode-beta.app/Contents/Developer  (xcode-select default)
  2) /Applications/Xcode.app/Contents/Developer
Choose (1-2, default 1):

Default = the Xcode selected by xcode-select → the preset uses command: xcrun mcpbridge (portable; follows future xcode-select changes).
Pick another → the chosen …/Contents/Developer/usr/bin/mcpbridge is baked into the installed preset as an absolute path.
Non-interactive: ./install.sh --xcode /Applications/Xcode.app (or --xcode …/Contents/Developer); ./install.sh --list-xcodes prints the candidates.
Switch at runtime without reinstalling: ./install.sh --runtime-selectable installs bin/mcpbridge as the command; set DSH_XCODE_DEVELOPER_DIR=/Applications/…/Contents/Developer when launching dsh to switch. (Resolution: DSH_XCODE_DEVELOPER_DIR → xcrun → newest /Applications/Xcode*.app.)

To change the choice later: re-run ./install.sh, edit the mcp-xcode row in ~/.dsh/.agent-presets/apple/agent.cordis.yml, or use the runtime env var above.

Alternative: global MCP wiring (MCP in every session)

- insert:
    - id: mcp-xcode
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: xcode
        transport: stdio
        command: xcrun
        args: ['mcpbridge']
        toolCallTimeoutMs: 120000

Use one path, not both: two live instances with serverName: xcode collide and the later one fails to load. See docs/global-mcp.md.

Usage

Restart dsh (or just open a new session — the preset can only be selected on a blank session).
Pick Apple Mode as the agent preset when creating the session.
The session now has:
- mcp__xcode__* tools — operate the open Xcode workspace: XcodeRead/Write/Update/MV/RM, XcodeGlob/Grep/LS, UpdateTargetBuildSetting/UpdateFileCompilerFlags, XcodeListNavigatorIssues, scheme/run-destination/test-plan switching, XcodeNewTarget, StringCatalogRead/Edit, …
- All Apple platform skills (lazy-loaded on demand).
- An Apple-first, tool-assisted working style.

Before using the mcp__xcode__* tools:

Xcode must be running with the project/workspace you want to work on opened in it.

On first connection, Xcode shows an MCP access dialog — click Allow (允许). Until you do, tool calls will be rejected.

What you get

MCP tools (26, namespaced `mcpxcode*`)

Group	Tools
Project I/O	`XcodeRead` `XcodeWrite` `XcodeUpdate` `XcodeMV` `XcodeRM` `XcodeMakeDir`
Search	`XcodeGlob` `XcodeGrep` `XcodeLS`
Targets & settings	`XcodeNewTarget` `XcodeListTemplates` `XcodeListTargets` `UpdateTargetBuildSetting` `UpdateFileCompilerFlags`
Scheme / destination / tests	`XcodeListSchemes` `XcodeSwitchScheme` `XcodeListRunDestinations` `XcodeSwitchRunDestination` `XcodeListTestPlans` `XcodeSwitchTestPlan`
Diagnostics	`XcodeListNavigatorIssues` `XcodeRefreshCodeIssuesInFile`
Localization	`StringCatalogRead` `StringCatalogEdit`
Windows	`XcodeListWindows` `XcodeGetCurrentFile`

Skills (10, generated at install time)

Repository layout

.
├── presets/apple/            # The agent preset: agent.cordis.yml + preset.yml
├── bin/mcpbridge             # Runtime-selectable mcpbridge launcher (--runtime-selectable)
├── cordis.patch.yml          # Bundle patch: declares the Apple Mode preset (DSH 0.2+)
├── package.json              # Bundle manifest (dsh.bundle.patch)
├── docs/
│   ├── XCODE_AI_INTEGRATION.md  # Full integration notes (Chinese)
│   ├── global-mcp.md            # Alternative: wire the MCP server into every session
│   └── publishing.md            # Publishing this package to npm
├── install.sh               # Xcode picker + preset install + local skills generation
├── uninstall.sh
└── LICENSE                  # MIT

Customization

Different Xcode: re-run ./install.sh (picker), ./install.sh --xcode <path> (non-interactive), --runtime-selectable + DSH_XCODE_DEVELOPER_DIR, or add env: { MCP_XCODE_PID: '<pid>' } to the mcp-xcode row to drive a specific running instance. See Choosing an Xcode.
Persona: edit the persona row text in the same file.
Sync skills after Xcode updates: re-run ./install.sh (skills are replaced, preset is backed up).
Keep in sync with upstream standard preset: diff against node_modules/@deepseek-ai/dsh/config/agent-presets/standard/agent.cordis.yml.

Security notes

MCP tool calls do not go through the DSH file sandbox — they go through the tool-approval flow. XcodeUpdate/XcodeWrite modify real Xcode project files (including project.pbxproj).
The preset only activates when you select it; no global config is touched by install.sh.

Contributing

PRs welcome. Open an issue for feature requests. If you publish your own DSH extension, add the dsh-plugin topic for discoverability and consider submitting it to awesome-dsh-plugin.

Apple Mode

兼容性与来源证明

版本

相关插件

Apple Mode

README

dsh-apple-mode

Why a preset (mode) instead of a global MCP wiring?

Requirements

Install

DSH 0.2.0+ (desktop app / current) — recommended

DSH 0.1.x — legacy on-disk preset

Version compatibility

Choosing an Xcode (multiple installs)

Alternative: global MCP wiring (MCP in every session)

Usage

What you get

MCP tools (26, namespaced mcp__xcode__*)

Skills (10, generated at install time)

Repository layout

Customization

Security notes

Contributing

License

兼容性与来源证明

版本

相关插件

相关插件

相关插件

README

dsh-apple-mode

Why a preset (mode) instead of a global MCP wiring?

Requirements

Install

DSH 0.2.0+ (desktop app / current) — recommended

DSH 0.1.x — legacy on-disk preset

Version compatibility

Choosing an Xcode (multiple installs)

Alternative: global MCP wiring (MCP in every session)

Usage

What you get

MCP tools (26, namespaced mcp__xcode__*)

Skills (10, generated at install time)

Repository layout

Customization

Security notes

Contributing

License

MCP tools (26, namespaced `mcpxcode*`)

MCP tools (26, namespaced `mcpxcode*`)