// Creates or removes a git worktree using the project scripts and shared config. Use when the user asks to create a worktree, add a worktree, remove a worktree, delete a worktree, or work on a parallel branch in a separate directory.
Create and update repo-local skills that follow the MetaMask Mobile standard. Use for new repo-local skills, skill entrypoints, or harness shims in this repository.
Add and fix Detox E2E tests (smoke and regression) for MetaMask Mobile using withFixtures, Page Objects, and tests/framework. Use when creating a new spec, fixing a failing E2E test, adding page objects and selectors, or adding MetaMetrics analytics expectations (analyticsExpectations).
Write, fix, and update component view tests (*.view.test.tsx) for MetaMask Mobile using the tests/component-view/ framework. Use when creating a new view test file, fixing a failing view test, updating tests after a component change, or creating a new renderer or preset for a view.
Create and review E2E performance tests that measure real user flows on real devices with TimerHelper and PerformanceTracker. Use when creating, editing, or reviewing performance tests, when the user mentions perf tests, timing measurements, performance thresholds, or files in tests/performance/.
Generate a CHANGELOG entry line for a pull request from code changes. Use when the user asks to write a changelog entry, fill the changelog section of a PR, or determine if changes are user-facing.
Identify code owners for changed files and map them to Slack group handles. Use when the user asks who owns changed files, which teams to tag for review, or to find code owners for a PR.
| name | worktree-create |
| description | Creates or removes a git worktree using the project scripts and shared config. Use when the user asks to create a worktree, add a worktree, remove a worktree, delete a worktree, or work on a parallel branch in a separate directory. |
Run from the repo root:
yarn worktree:create <path> <branch> or yarn worktree:create <path> <branch> --from main for a new branch. Use yarn worktree:create --cd <path> <branch> to spawn a shell in the new worktree after create.yarn worktree:create without arguments so the script runs in interactive mode; the user can enter path and branch in the terminal.Do not run raw git worktree add or manual copy/setup steps; the script runs the commands from .cursor/worktrees.json as the single source of truth.
After the script succeeds, remind the user to run yarn setup or yarn setup:expo and git submodule update --init --recursive in the new worktree as needed.
yarn worktree:remove <path>.yarn worktree:remove (interactive; lists worktrees and prompts to choose).Full worktree docs: Development Process – Git worktrees.