ailinks:

Codex/new-task

Start a task

Opens a new Codex task with the composer pre-filled, in a chosen workspace.

macos · windows · updated 2026-07-12

Format

codex://new?prompt={prompt}&path={path}

Try it

codex://new?prompt=Fix%20the%20failing%20auth%20tests&path=/Users/me/projectOpen

What you supply

{prompt}optional

Text to place in the composer.

URL-encode it.

{path}optional

Absolute path of the workspace directory to open in.

Must exist on the reader's machine. If it does not, the link fails silently.

codex://threads/new?… is the same thing under a longer name and takes the same parameters.

There is a third parameter worth knowing about: originUrl, which takes a git remote URL and matches a workspace by that instead of by an absolute path. It is resolved only after path fails, so path wins when both are present. originUrl is the better choice for a link you are sharing, since it does not assume where the reader keeps their clone.

A path that does not exist does not raise anything. The link just does not land.