# Setup Mac2

> Prepare and verify Appium Mac2 for native macOS automation by validating Node/Appium, macOS and Xcode tooling, driver installation, doctor output, privacy authorization boundaries, and server smoke evidence. Use after the setup Skill selects Mac2. Do not use for an existing Mac2 runtime failure after prerequisites pass.

- **Type:** Skill
- **Install:** `agentstack add skill-appium-skills-setup-mac2`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [appium](https://agentstack.voostack.com/s/appium)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [appium](https://github.com/appium)
- **Source:** https://github.com/appium/skills/tree/main/skills/setup-mac2

## Install

```sh
agentstack add skill-appium-skills-setup-mac2
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Mac2 Setup Workflow

## Mac2 setup routing and handoffs

Prepare only the Appium Mac2 route on macOS. Use driver-specific official
guidance for an existing runtime failure after setup passes.

## Required inputs

Confirm macOS as the host and target, global `appium` mode or explicitly
requested local `npx appium` mode, Xcode tooling state, permissions, and any
required privacy authorization state.

## Workflow outline

1. Load the global command profile by default or the local profile only when
   explicitly requested.
2. Load the macOS and Mac2 profiles, shared Appium setup basics, Xcode
   command-line-tools Context, and Mac2 decision, doctor, and smoke references.
3. Run `node tools/appium/setup/scripts/check-mac2-env.mjs`; pass
   `--appium-mode local` only for local mode. Use
   `summary.requiredOk: true` as the read-only setup gate.
4. Apply required fixes in technical dependency order and rerun the affected
   check.
5. Run the Mac2 doctor and server smoke checks. Load the matching example only
   when it clarifies execution.

## Mac2 setup safety and approval constraints

- Require macOS.
- Ask before privileged commands, Xcode license or first-launch changes, or
  privacy-setting changes.
- Preserve the selected command mode and working Xcode and driver
  installations.

## Completion criteria

- `xcodebuild -version` and `xcode-select -p` succeed.
- Xcode license and first-launch requirements are handled.
- Appium succeeds in the selected command mode and the installed list includes
  `mac2`.
- `appium driver doctor mac2` reports `0 required fixes needed`.
- Required privacy permissions are user-approved when session startup needs
  them.
- `/status` succeeds and logs list `mac2`.

## Evidence boundary

Report Xcode tooling, Appium and driver versions, helper and doctor summaries,
privacy authorization blockers, `/status`, server driver evidence, and cleanup.

## Self-Improvement Prompt

Before the final response, report any missing, ambiguous, outdated, or
retry-causing Mac2 setup instruction with its asset path and proposed wording.
Leave unrelated assets unchanged.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [appium](https://github.com/appium)
- **Source:** [appium/skills](https://github.com/appium/skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-appium-skills-setup-mac2
- Seller: https://agentstack.voostack.com/s/appium
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.