Start a session

Opens a project and starts a new session in it, with an optional prompt in the composer.

macos · windows · linux · updated 2026-07-13

Format

opencode://new-session?directory={directory}&prompt={prompt}

opencode://new-session?directory=%2FUsers%2Fme%2Fproject&prompt=Fix%20the%20failing%20auth%20testsOpen

{directory}

Absolute path to the project the session runs in.

URL-encode it. A Windows path works too — C%3A%5Cpath%5Cto%5Cproject.

{prompt}optional

Text to place in the composer.

URL-encode it.

directory is required even here — a new-session link without one is dropped, prompt and all. The project opens first, then the session inside it.

Leave prompt off and you get an empty session in that project, which is the difference between this and Open a project.