Module handoff_url 

vtcode:// handoff links: open the desktop app at a thread from the CLI.

Contract shared by the CLI (producer) and the desktop app (consumer): vtcode://session/<archive-id>?workspace=<url-encoded-absolute-path>. Parsing is fail-closed: anything else yields None and the URL is ignored. Paths decode lossy on purpose: a mangled path fails workspace canonicalization later and surfaces invalid-folder instead of linking somewhere unexpected.

Structs

HandoffLink

A parsed handoff link: load this thread in this workspace.

Constants

HANDOFF_SCHEME

URL scheme claimed by the desktop bundle (CFBundleURLTypes).

Functions

handoff_url

Build the canonical handoff URL for a link.

parse_handoff_url

Parse a handoff URL. Returns None for any other shape.