DevKit Code

Show the connection card only when the user explicitly asks about DevKit setup, connection or readiness. For normal repo tasks, read devkit_status silently instead. Does not grant access or install providers.

devkit_tools

Read the next progress or saved final result of an owned asynchronous task. Keep calling the returned continuation while queued, running or awaiting_approval; do not end the answer at a Mac permission wait. A read waits for up to eight seconds and may return unchanged progress. Nonterminal results include the next read-only continuation. This operation never starts, retries, cancels or grants permission. Owned saved reads remain available after entitlement expiry.

codex_job_wait

Find the code folder for the user's request on their paired computer. List up to 100 child directory names, including safe directory symlinks, without reading contents or starting work. Default is the Mac's home directory. Browse relevant directories only; never crawl recursively. Follow nextCursor with the same path. No registration is required. Ask in the conversation only when the intended folder is ambiguous. Protected credentials and private agent state are excluded.

codex_folders

Cancel an owned job only when the user requests cancellation. Never cancel automatically because it is queued, awaiting a local decision, quiet, or taking several minutes. Cancellation can leave partial work and does not undo earlier filesystem changes. Fixture mode has no filesystem effects.

codex_job_cancel

Use this when reviewing file changes from an owned Codex job on the selected device. Returns a redacted bounded diff from its isolated worktree. Does not apply changes or access other projects. Available after entitlement expiry.

codex_job_changes

Continue the existing owned task for follow-ups such as also, extend, change, or run another check. Reuse its provider thread and working copy, preserving earlier changes. Use this instead of codex_job_start, including after a dropped connection. Nonterminal results include an owned read-only continuation. Answer task input for an owned awaiting_input job, or continue an owned completed job in the same project and local policy. Reuse requestId for identical retries. Permission decisions stay local. Fixture mode never runs real Codex inference.

codex_job_reply

Start NEW independent work only. For a follow-up to a completed owned task, use codex_job_reply with its jobId; never start a replacement after a connection error. Start an investigation, code change or check in the user-named folder on the selected paired Mac. Resolve the folder with codex_folders and provide exactly one of absolute cwd or legacy projectId. No project registration is required. This is asynchronous; nonterminal results include the exact read-only continuation for the owned task. Local approval remains a separate Mac decision. Identical retries reuse requestId. Queued jobs are admitted and wait for local capacity; inspect their existing status. Git jobs use isolated committed-HEAD worktrees; non-Git jobs run in the selected folder. Execution may modify or delete files. The Mac sandbox, model and local permission settings apply. Simulated execution is labelled.

codex_job_start

Read owned task progress and the saved final answer. Keep identifiers internal; summarize the final answer once, without progress commentary or a status table. Only completed is success. Simulated jobs are explicitly labelled.

codex_job_status

Revoke a device owned by the authenticated account and immediately close its routing connection. Running local adapter work is interrupted when revocation reaches the agent.

device_revoke

List only the authenticated account's devices.

devkit_devices