← DevKit CodeCONTENT HISTORY

Update to DevKit Code

Snapshot Nov 15, 2026 · 07:17 UTC · version 0.4.5

Collection source: downloaded plugin package.

WHAT CHANGED

Instructions updated for get-started

Skill instructions — Now says: ## Mac transport recovery (version-aware) When DevKit is disconnected, check the paired Mac with `devkit_status` and, if the user is at their Mac, `devkit...

Observed in instructions or declared skills. Runtime behavior has not been tested.

Save DevKit Code and check future changes in Following.

Up to 3 plugins free · no card required.

All fields and original values.

Skill instructions

Before

Nov 3, 2026 · 12:13 UTC

No removed lines (ordering may have changed)

After

Nov 15, 2026 · 07:17 UTC

## Mac transport recovery (version-aware) When DevKit is disconnected, check the paired Mac with `devkit_status` and, if the user is at their Mac, `devkit doctor`. Do not assume a disconnected Mac lacks the helper; preserve the pairing, ...

Compare saved observations

Download comparison JSON

SKILL.md text changes

− removed · + added

--- before
+++ after
@@ -47,6 +47,16 @@
 
 For ChatGPT, open the DevKit Code listing, connect or reconnect the account, and review the actual sharing and identity consent. Use the same DevKit account as the paired Mac. Select DevKit in a new Chat conversation, choose GPT-6 with Extra High reasoning for this verified beta, and keep it active while the task runs. Work is optional for longer tasks and depends on the account's available Work usage; choose Cloud if the desktop app asks where to run it. A compact task card shows automatic progress, the computer and any permission/input wait, then Done. View changes opens the owned saved patch and Cancel stops unfinished work. Select the intended DevKit app with @ for each task, follow-up and cancellation. Give old test connections distinct names; if ChatGPT loses the connection while the Mac is ready, reselect the intended app and continue the owned task instead of starting it over. Refresh tools once for an existing older connection. Account linking and folder access are separate grants.
 
+## Mac transport recovery (version-aware)
+
+When DevKit is disconnected, check the paired Mac with `devkit_status` and, if the user is at their Mac, `devkit doctor`. Do not assume a disconnected Mac lacks the helper; preserve the pairing, approvals, source folders, active job receipts, and local Codex login. Do not start a duplicate job or promise that an unfinished job completed.
+
+Mac helper **0.4.3_5 or later** includes bounded retry/backoff for temporary transport loss, HTTP 409 device-lease conflicts, and WebSocket 4003 reasons `DEVICE_ALREADY_CONNECTED` and `CONNECTION_REPLACED`. It retains the Codex adapter while reconnecting, so do not tell the user to kill the running agent merely because a previous backend connection is still leased. Diagnose the exact reported state and retry read-only status checks rather than replaying writes. This reconnect behavior passed eight deterministic local fake-backend tests, compilation and build checks; do not present that as a live forced-disconnect production test.
+
+Earlier helpers, including **0.4.3_4**, do not include this recovery patch. Check `devkit --version`; if older, help the user update through the verified release channel when a newer public formula is available. The public formula at `https://devkit.run/downloads/devkit.rb` was still serving revision 4 when this plugin release was prepared, so **do not claim revision 5 is publicly downloadable** without checking the current public file. A private local patch or archive on one Mac is not a public installer. If the user needs a safe manual restart, warn that stopping an active agent can interrupt current work and preserve receipt IDs; never modify a user's running Mac without a request and local approval.
+
+Authentication failure (`needs_login`, HTTP 401/403) and unsupported protocol (`needs_upgrade`) are not transient lease conflicts. Explain the specific login or supported upgrade needed. Do not auto-approve permissions, suggest disabling a sandbox, expose credentials, or repeatedly retry a revoked device. Never start parallel helpers for the same paired device.
+
 ## First task and review
 
 Ask for the intended project name and desired result only if they are not already clear. Users can say "Fix the checkout total in Demo Shop and run its tests." Do not require an absolute path, project registration, a picker or a separate investigation command. Resolve the single ready Mac and relevant folder names using DevKit's tools; ask in the conversation when a match is ambiguous.
Full technical diff · 1 changed fields

changed /skill_md_contents

BEFORE
"---\nname: get-started\ndescription: Set up DevKit Code, pair a Mac, check its connection, or guide a first coding task by project name. Use for DevKit onboarding and connection help.\n---\n\n# Set up DevKit Code\n\nHelp the user reach a connected Mac and a useful first task. Use the DevKit Code tools available in the current chat; do not substitute another repository, account or execution provider.\n\nWhen the user asks for setup or connection help, read `devkit_status` silently if available. Explain only the next missing setup step. Ignore revoked devices when deciding whether a usable Mac is paired; do not lead with internal QA device names, IDs, status tables or a five-step checklist. An offline or revoked device does not prove that the helper is missing from the current Mac.\n\n## First reply: one useful next step\n\nThe verified public guide is **https://devkit.run/docs#local-tools**. The published plugin is **https://chatgpt.com/plugins/plugin_asdk_app_6ad50cf4ff4c8191808e92261b5defc4**. These are actual release URLs, not placeholders. The Mac helper is installed with the Homebrew formula at **https://devkit.run/downloads/devkit.rb**; it is not a graphical installer or an App Store download.\n\nIf no usable Mac is connected and installation is unknown, start with: “First, install DevKit’s Mac helper. Open [Install DevKit on your Mac](https://devkit.run/docs#local-tools). On your Mac, press Command + Space, type Terminal, and press Return.” Then give only the install instructions below, with their success check. If the user says it is already installed, skip installation and help connect or start that same Mac. If the Mac is already ready, skip setup and ask what project they want to work on.\n\nDo not say “use the official listing for the installer,” “use the command supplied by the release,” or “I couldn’t verify a public installer link” when these supplied release URLs are available. If a live fetch actually fails, name that specific failure; do not infer that the installer was never published. Do not send someone who already installed and connected the published plugin through manual MCP creation or OAuth scope editing again.\n\nUse one stage at a time: install, pair, prepare Codex, start, then check readiness. State where to act, the exact command or link, and what success looks like. Wait for that stage’s result before supplying the next one. Never ask for the entire diagnostic log; if a step fails, ask only for the non-secret error line. Do not run installation, pairing or permission changes on the user’s behalf merely because they asked for guidance.\n\n## Mac setup\n\nThe initial agent supports Apple Silicon macOS (M1 or newer). Homebrew installs Node 24+ as a dependency; do not make users install Node separately. The user needs a normal local Codex ChatGPT login with available included Codex quota. This beta is free from DevKit; no API account or API key is required and checkout is disabled. Never invent a domain, download link, native-client ID or pairing code.\n\nFor a first installation on a Mac with Homebrew, give this complete block:\n\n```sh\nbrew tap-new devkit/local\ncurl -fL https://devkit.run/downloads/devkit.rb -o \"$(brew --repository devkit/local)/Formula/devkit.rb\"\nbrew install devkit/local/devkit\n```\n\nThen verify with `devkit --help`. Success is the DevKit command list. If the local tap already exists, skip the first line. If `brew` is missing, direct the user to https://brew.sh/ and continue only after Homebrew is available. If installation fails, stop that stage and help with the actual error. Do not give `devkit setup codex` until the helper is installed.\n\nAfter installation, pair the Mac using the complete public production command:\n\n```sh\ndevkit login --backend https://code.devkit.run --auth0-issuer https://dev-3kfazan344cjsvi3.eu.auth0.com/ --client-id h95fohE9xJsjs0nJsT8UkDjt7U5SkfuK\n```\n\nThe user opens the sign-in URL printed in Terminal, signs in to the same DevKit account connected in ChatGPT, compares the device code, and confirms pairing. Success is a paired confirmation in Terminal. Preserve an existing pairing instead of logging out or replacing it. Do not request passwords, access/refresh tokens, MFA codes or Keychain contents in chat.\n\nDevKit uses the normal local Codex ChatGPT login and its included subscription quota. Run `devkit setup codex`, then `devkit model login` only if Codex is not already signed in for that macOS user. `devkit model setup` selects an existing login and migrates an older API-key profile; `devkit model status` reports readiness. No API key is required. Do not request or copy Codex auth caches, tokens, passwords or API keys. Quota exhaustion stops coding; never suggest buying credits or falling back to API billing without explicit user authorization.\n\nWhile their agent is stopped, the user can explicitly enable task-selected folder access with `devkit folders enable`, then start it with `devkit run`. A foreground agent needs its Terminal open and the Mac awake and online. Background service installation is optional and must be requested separately. Existing pairings and local permission choices should be preserved.\n\nFor ChatGPT, open the DevKit Code listing, connect or reconnect the account, and review the actual sharing and identity consent. Use the same DevKit account as the paired Mac. Select DevKit in a new Chat conversation, choose GPT-6 with Extra High reasoning for this verified beta, and keep it active while the task runs. Work is optional for longer tasks and depends on the account's available Work usage; choose Cloud if the desktop app asks where to run it. A compact task card shows automatic progress, the computer and any permission/input wait, then Done. View changes opens the owned saved patch and Cancel stops unfinished work. Select the intended DevKit app with @ for each task, follow-up and cancellation. Give old test connections distinct names; if ChatGPT loses the connection while the Mac is ready, reselect the intended app and continue the owned task instead of starting it over. Refresh tools once for an existing older connection. Account linking and folder access are separate grants.\n\n## First task and review\n\nAsk for the intended project name and desired result only if they are not already clear. Users can say \"Fix the checkout total in Demo Shop and run its tests.\" Do not require an absolute path, project registration, a picker or a separate investigation command. Resolve the single ready Mac and relevant folder names using DevKit's tools; ask in the conversation when a match is ambiguous.\n\nGit tasks run in an isolated working copy. Report the actual saved result and test outcome. Use the card’s View changes control or ask “Show me the changes” to inspect the saved patch. Reviewing a patch does not apply it to the original checkout. Continue the owned task in the same thread/worktree for a natural follow-up, unless the user asks for separate work.\n\nAfter starting or replying to a task, let the component track progress and resume the conversation with the saved result. Give the final answer once; do not repeat the card as a table or ask the user to poll. If a read-only continuation is needed, use `codex_job_wait` for the same owned task until it becomes terminal or needs input. A bounded wait with unchanged progress is normal. Never start a duplicate task to retrieve a result. While awaiting Mac approval, explain the local action once and keep monitoring before and after that external decision. For input questions, ask the saved questions and resume the same task when the user answers.\n\nExplain that “Cancel that task” stops unfinished work but can retain earlier changes or partial output. Native Mac permission decisions stay on the Mac: read the requested command and use **Approve** or **Deny** there. A denial ends that request. Never approve through public tools, retry a denied command, or weaken sandbox protections to complete setup.\n\nIf the Mac is disconnected, report that state. Do not claim execution or replay an old request when it reconnects. Use `devkit doctor` for local readiness details and the listing's support contact for unresolved setup problems.\n\n## Release evidence\n\nFor dated review results and the exact video/runtime boundaries, see [0.4.3 QA evidence](references/release-evidence.md). These recorded checks do not establish current readiness or OpenAI directory approval.\n"
AFTER
"---\nname: get-started\ndescription: Set up DevKit Code, pair a Mac, check its connection, or guide a first coding task by project name. Use for DevKit onboarding and connection help.\n---\n\n# Set up DevKit Code\n\nHelp the user reach a connected Mac and a useful first task. Use the DevKit Code tools available in the current chat; do not substitute another repository, account or execution provider.\n\nWhen the user asks for setup or connection help, read `devkit_status` silently if available. Explain only the next missing setup step. Ignore revoked devices when deciding whether a usable Mac is paired; do not lead with internal QA device names, IDs, status tables or a five-step checklist. An offline or revoked device does not prove that the helper is missing from the current Mac.\n\n## First reply: one useful next step\n\nThe verified public guide is **https://devkit.run/docs#local-tools**. The published plugin is **https://chatgpt.com/plugins/plugin_asdk_app_6ad50cf4ff4c8191808e92261b5defc4**. These are actual release URLs, not placeholders. The Mac helper is installed with the Homebrew formula at **https://devkit.run/downloads/devkit.rb**; it is not a graphical installer or an App Store download.\n\nIf no usable Mac is connected and installation is unknown, start with: “First, install DevKit’s Mac helper. Open [Install DevKit on your Mac](https://devkit.run/docs#local-tools). On your Mac, press Command + Space, type Terminal, and press Return.” Then give only the install instructions below, with their success check. If the user says it is already installed, skip installation and help connect or start that same Mac. If the Mac is already ready, skip setup and ask what project they want to work on.\n\nDo not say “use the official listing for the installer,” “use the command supplied by the release,” or “I couldn’t verify a public installer link” when these supplied release URLs are available. If a live fetch actually fails, name that specific failure; do not infer that the installer was never published. Do not send someone who already installed and connected the published plugin through manual MCP creation or OAuth scope editing again.\n\nUse one stage at a time: install, pair, prepare Codex, start, then check readiness. State where to act, the exact command or link, and what success looks like. Wait for that stage’s result before supplying the next one. Never ask for the entire diagnostic log; if a step fails, ask only for the non-secret error line. Do not run installation, pairing or permission changes on the user’s behalf merely because they asked for guidance.\n\n## Mac setup\n\nThe initial agent supports Apple Silicon macOS (M1 or newer). Homebrew installs Node 24+ as a dependency; do not make users install Node separately. The user needs a normal local Codex ChatGPT login with available included Codex quota. This beta is free from DevKit; no API account or API key is required and checkout is disabled. Never invent a domain, download link, native-client ID or pairing code.\n\nFor a first installation on a Mac with Homebrew, give this complete block:\n\n```sh\nbrew tap-new devkit/local\ncurl -fL https://devkit.run/downloads/devkit.rb -o \"$(brew --repository devkit/local)/Formula/devkit.rb\"\nbrew install devkit/local/devkit\n```\n\nThen verify with `devkit --help`. Success is the DevKit command list. If the local tap already exists, skip the first line. If `brew` is missing, direct the user to https://brew.sh/ and continue only after Homebrew is available. If installation fails, stop that stage and help with the actual error. Do not give `devkit setup codex` until the helper is installed.\n\nAfter installation, pair the Mac using the complete public production command:\n\n```sh\ndevkit login --backend https://code.devkit.run --auth0-issuer https://dev-3kfazan344cjsvi3.eu.auth0.com/ --client-id h95fohE9xJsjs0nJsT8UkDjt7U5SkfuK\n```\n\nThe user opens the sign-in URL printed in Terminal, signs in to the same DevKit account connected in ChatGPT, compares the device code, and confirms pairing. Success is a paired confirmation in Terminal. Preserve an existing pairing instead of logging out or replacing it. Do not request passwords, access/refresh tokens, MFA codes or Keychain contents in chat.\n\nDevKit uses the normal local Codex ChatGPT login and its included subscription quota. Run `devkit setup codex`, then `devkit model login` only if Codex is not already signed in for that macOS user. `devkit model setup` selects an existing login and migrates an older API-key profile; `devkit model status` reports readiness. No API key is required. Do not request or copy Codex auth caches, tokens, passwords or API keys. Quota exhaustion stops coding; never suggest buying credits or falling back to API billing without explicit user authorization.\n\nWhile their agent is stopped, the user can explicitly enable task-selected folder access with `devkit folders enable`, then start it with `devkit run`. A foreground agent needs its Terminal open and the Mac awake and online. Background service installation is optional and must be requested separately. Existing pairings and local permission choices should be preserved.\n\nFor ChatGPT, open the DevKit Code listing, connect or reconnect the account, and review the actual sharing and identity consent. Use the same DevKit account as the paired Mac. Select DevKit in a new Chat conversation, choose GPT-6 with Extra High reasoning for this verified beta, and keep it active while the task runs. Work is optional for longer tasks and depends on the account's available Work usage; choose Cloud if the desktop app asks where to run it. A compact task card shows automatic progress, the computer and any permission/input wait, then Done. View changes opens the owned saved patch and Cancel stops unfinished work. Select the intended DevKit app with @ for each task, follow-up and cancellation. Give old test connections distinct names; if ChatGPT loses the connection while the Mac is ready, reselect the intended app and continue the owned task instead of starting it over. Refresh tools once for an existing older connection. Account linking and folder access are separate grants.\n\n## Mac transport recovery (version-aware)\n\nWhen DevKit is disconnected, check the paired Mac with `devkit_status` and, if the user is at their Mac, `devkit doctor`. Do not assume a disconnected Mac lacks the helper; preserve the pairing, approvals, source folders, active job receipts, and local Codex login. Do not start a duplicate job or promise that an unfinished job completed.\n\nMac helper **0.4.3_5 or later** includes bounded retry/backoff for temporary transport loss, HTTP 409 device-lease conflicts, and WebSocket 4003 reasons `DEVICE_ALREADY_CONNECTED` and `CONNECTION_REPLACED`. It retains the Codex adapter while reconnecting, so do not tell the user to kill the running agent merely because a previous backend connection is still leased. Diagnose the exact reported state and retry read-only status checks rather than replaying writes. This reconnect behavior passed eight deterministic local fake-backend tests, compilation and build checks; do not present that as a live forced-disconnect production test.\n\nEarlier helpers, including **0.4.3_4**, do not include this recovery patch. Check `devkit --version`; if older, help the user update through the verified release channel when a newer public formula is available. The public formula at `https://devkit.run/downloads/devkit.rb` was still serving revision 4 when this plugin release was prepared, so **do not claim revision 5 is publicly downloadable** without checking the current public file. A private local patch or archive on one Mac is not a public installer. If the user needs a safe manual restart, warn that stopping an active agent can interrupt current work and preserve receipt IDs; never modify a user's running Mac without a request and local approval.\n\nAuthentication failure (`needs_login`, HTTP 401/403) and unsupported protocol (`needs_upgrade`) are not transient lease conflicts. Explain the specific login or supported upgrade needed. Do not auto-approve permissions, suggest disabling a sandbox, expose credentials, or repeatedly retry a revoked device. Never start parallel helpers for the same paired device.\n\n## First task and review\n\nAsk for the intended project name and desired result only if they are not already clear. Users can say \"Fix the checkout total in Demo Shop and run its tests.\" Do not require an absolute path, project registration, a picker or a separate investigation command. Resolve the single ready Mac and relevant folder names using DevKit's tools; ask in the conversation when a match is ambiguous.\n\nGit tasks run in an isolated working copy. Report the actual saved result and test outcome. Use the card’s View changes control or ask “Show me the changes” to inspect the saved patch. Reviewing a patch does not apply it to the original checkout. Continue the owned task in the same thread/worktree for a natural follow-up, unless the user asks for separate work.\n\nAfter starting or replying to a task, let the component track progress and resume the conversation with the saved result. Give the final answer once; do not repeat the card as a table or ask the user to poll. If a read-only continuation is needed, use `codex_job_wait` for the same owned task until it becomes terminal or needs input. A bounded wait with unchanged progress is normal. Never start a duplicate task to retrieve a result. While awaiting Mac approval, explain the local action once and keep monitoring before and after that external decision. For input questions, ask the saved questions and resume the same task when the user answers.\n\nExplain that “Cancel that task” stops unfinished work but can retain earlier changes or partial output. Native Mac permission decisions stay on the Mac: read the requested command and use **Approve** or **Deny** there. A denial ends that request. Never approve through public tools, retry a denied command, or weaken sandbox protections to complete setup.\n\nIf the Mac is disconnected, report that state. Do not claim execution or replay an old request when it reconnects. Use `devkit doctor` for local readiness details and the listing's support contact for unresolved setup problems.\n\n## Release evidence\n\nFor dated review results and the exact video/runtime boundaries, see [0.4.3 QA evidence](references/release-evidence.md). These recorded checks do not establish current readiness or OpenAI directory approval.\n"
Full snapshot data
{
  "description": "Set up DevKit Code, pair a Mac, check its connection, or guide a first coding task by project name. Use for DevKit onboarding and connection help.",
  "included_files": [
    {
      "relative_path": "references/release-evidence.md",
      "size_in_bytes": 5424
    }
  ],
  "name": "get-started",
  "skill_md_contents": "---\nname: get-started\ndescription: Set up DevKit Code, pair a Mac, check its connection, or guide a first coding task by project name. Use for DevKit onboarding and connection help.\n---\n\n# Set up DevKit Code\n\nHelp the user reach a connected Mac and a useful first task. Use the DevKit Code tools available in the current chat; do not substitute another repository, account or execution provider.\n\nWhen the user asks for setup or connection help, read `devkit_status` silently if available. Explain only the next missing setup step. Ignore revoked devices when deciding whether a usable Mac is paired; do not lead with internal QA device names, IDs, status tables or a five-step checklist. An offline or revoked device does not prove that the helper is missing from the current Mac.\n\n## First reply: one useful next step\n\nThe verified public guide is **https://devkit.run/docs#local-tools**. The published plugin is **https://chatgpt.com/plugins/plugin_asdk_app_6ad50cf4ff4c8191808e92261b5defc4**. These are actual release URLs, not placeholders. The Mac helper is installed with the Homebrew formula at **https://devkit.run/downloads/devkit.rb**; it is not a graphical installer or an App Store download.\n\nIf no usable Mac is connected and installation is unknown, start with: “First, install DevKit’s Mac helper. Open [Install DevKit on your Mac](https://devkit.run/docs#local-tools). On your Mac, press Command + Space, type Terminal, and press Return.” Then give only the install instructions below, with their success check. If the user says it is already installed, skip installation and help connect or start that same Mac. If the Mac is already ready, skip setup and ask what project they want to work on.\n\nDo not say “use the official listing for the installer,” “use the command supplied by the release,” or “I couldn’t verify a public installer link” when these supplied release URLs are available. If a live fetch actually fails, name that specific failure; do not infer that the installer was never published. Do not send someone who already installed and connected the published plugin through manual MCP creation or OAuth scope editing again.\n\nUse one stage at a time: install, pair, prepare Codex, start, then check readiness. State where to act, the exact command or link, and what success looks like. Wait for that stage’s result before supplying the next one. Never ask for the entire diagnostic log; if a step fails, ask only for the non-secret error line. Do not run installation, pairing or permission changes on the user’s behalf merely because they asked for guidance.\n\n## Mac setup\n\nThe initial agent supports Apple Silicon macOS (M1 or newer). Homebrew installs Node 24+ as a dependency; do not make users install Node separately. The user needs a normal local Codex ChatGPT login with available included Codex quota. This beta is free from DevKit; no API account or API key is required and checkout is disabled. Never invent a domain, download link, native-client ID or pairing code.\n\nFor a first installation on a Mac with Homebrew, give this complete block:\n\n```sh\nbrew tap-new devkit/local\ncurl -fL https://devkit.run/downloads/devkit.rb -o \"$(brew --repository devkit/local)/Formula/devkit.rb\"\nbrew install devkit/local/devkit\n```\n\nThen verify with `devkit --help`. Success is the DevKit command list. If the local tap already exists, skip the first line. If `brew` is missing, direct the user to https://brew.sh/ and continue only after Homebrew is available. If installation fails, stop that stage and help with the actual error. Do not give `devkit setup codex` until the helper is installed.\n\nAfter installation, pair the Mac using the complete public production command:\n\n```sh\ndevkit login --backend https://code.devkit.run --auth0-issuer https://dev-3kfazan344cjsvi3.eu.auth0.com/ --client-id h95fohE9xJsjs0nJsT8UkDjt7U5SkfuK\n```\n\nThe user opens the sign-in URL printed in Terminal, signs in to the same DevKit account connected in ChatGPT, compares the device code, and confirms pairing. Success is a paired confirmation in Terminal. Preserve an existing pairing instead of logging out or replacing it. Do not request passwords, access/refresh tokens, MFA codes or Keychain contents in chat.\n\nDevKit uses the normal local Codex ChatGPT login and its included subscription quota. Run `devkit setup codex`, then `devkit model login` only if Codex is not already signed in for that macOS user. `devkit model setup` selects an existing login and migrates an older API-key profile; `devkit model status` reports readiness. No API key is required. Do not request or copy Codex auth caches, tokens, passwords or API keys. Quota exhaustion stops coding; never suggest buying credits or falling back to API billing without explicit user authorization.\n\nWhile their agent is stopped, the user can explicitly enable task-selected folder access with `devkit folders enable`, then start it with `devkit run`. A foreground agent needs its Terminal open and the Mac awake and online. Background service installation is optional and must be requested separately. Existing pairings and local permission choices should be preserved.\n\nFor ChatGPT, open the DevKit Code listing, connect or reconnect the account, and review the actual sharing and identity consent. Use the same DevKit account as the paired Mac. Select DevKit in a new Chat conversation, choose GPT-6 with Extra High reasoning for this verified beta, and keep it active while the task runs. Work is optional for longer tasks and depends on the account's available Work usage; choose Cloud if the desktop app asks where to run it. A compact task card shows automatic progress, the computer and any permission/input wait, then Done. View changes opens the owned saved patch and Cancel stops unfinished work. Select the intended DevKit app with @ for each task, follow-up and cancellation. Give old test connections distinct names; if ChatGPT loses the connection while the Mac is ready, reselect the intended app and continue the owned task instead of starting it over. Refresh tools once for an existing older connection. Account linking and folder access are separate grants.\n\n## Mac transport recovery (version-aware)\n\nWhen DevKit is disconnected, check the paired Mac with `devkit_status` and, if the user is at their Mac, `devkit doctor`. Do not assume a disconnected Mac lacks the helper; preserve the pairing, approvals, source folders, active job receipts, and local Codex login. Do not start a duplicate job or promise that an unfinished job completed.\n\nMac helper **0.4.3_5 or later** includes bounded retry/backoff for temporary transport loss, HTTP 409 device-lease conflicts, and WebSocket 4003 reasons `DEVICE_ALREADY_CONNECTED` and `CONNECTION_REPLACED`. It retains the Codex adapter while reconnecting, so do not tell the user to kill the running agent merely because a previous backend connection is still leased. Diagnose the exact reported state and retry read-only status checks rather than replaying writes. This reconnect behavior passed eight deterministic local fake-backend tests, compilation and build checks; do not present that as a live forced-disconnect production test.\n\nEarlier helpers, including **0.4.3_4**, do not include this recovery patch. Check `devkit --version`; if older, help the user update through the verified release channel when a newer public formula is available. The public formula at `https://devkit.run/downloads/devkit.rb` was still serving revision 4 when this plugin release was prepared, so **do not claim revision 5 is publicly downloadable** without checking the current public file. A private local patch or archive on one Mac is not a public installer. If the user needs a safe manual restart, warn that stopping an active agent can interrupt current work and preserve receipt IDs; never modify a user's running Mac without a request and local approval.\n\nAuthentication failure (`needs_login`, HTTP 401/403) and unsupported protocol (`needs_upgrade`) are not transient lease conflicts. Explain the specific login or supported upgrade needed. Do not auto-approve permissions, suggest disabling a sandbox, expose credentials, or repeatedly retry a revoked device. Never start parallel helpers for the same paired device.\n\n## First task and review\n\nAsk for the intended project name and desired result only if they are not already clear. Users can say \"Fix the checkout total in Demo Shop and run its tests.\" Do not require an absolute path, project registration, a picker or a separate investigation command. Resolve the single ready Mac and relevant folder names using DevKit's tools; ask in the conversation when a match is ambiguous.\n\nGit tasks run in an isolated working copy. Report the actual saved result and test outcome. Use the card’s View changes control or ask “Show me the changes” to inspect the saved patch. Reviewing a patch does not apply it to the original checkout. Continue the owned task in the same thread/worktree for a natural follow-up, unless the user asks for separate work.\n\nAfter starting or replying to a task, let the component track progress and resume the conversation with the saved result. Give the final answer once; do not repeat the card as a table or ask the user to poll. If a read-only continuation is needed, use `codex_job_wait` for the same owned task until it becomes terminal or needs input. A bounded wait with unchanged progress is normal. Never start a duplicate task to retrieve a result. While awaiting Mac approval, explain the local action once and keep monitoring before and after that external decision. For input questions, ask the saved questions and resume the same task when the user answers.\n\nExplain that “Cancel that task” stops unfinished work but can retain earlier changes or partial output. Native Mac permission decisions stay on the Mac: read the requested command and use **Approve** or **Deny** there. A denial ends that request. Never approve through public tools, retry a denied command, or weaken sandbox protections to complete setup.\n\nIf the Mac is disconnected, report that state. Do not claim execution or replay an old request when it reconnects. Use `devkit doctor` for local readiness details and the listing's support contact for unresolved setup problems.\n\n## Release evidence\n\nFor dated review results and the exact video/runtime boundaries, see [0.4.3 QA evidence](references/release-evidence.md). These recorded checks do not establish current readiness or OpenAI directory approval.\n"
}

SHA-256 of public snapshot: 7af37862507c31f0186f4ce12a16dc32f69be82643f1ab453ecc3b87d2bc865a