Launch from Links
Syntic Code registers a syntic:// URL scheme so other applications can hand off directly into a session. Clicking a deep link — in a browser, a chat message, an issue tracker, or documentation — opens the CLI with a preloaded prompt and context. This bridges the gap between where work is discussed and where it gets done, letting you go from a link to a working agent in one step.
Anatomy of a deep link
A syntic:// link encodes the action, the target repository or path, and an optional prompt. The host segment names the action and query parameters carry the details:
# Open a session in a repo with a starting prompt
syntic://session?repo=/Users/me/app&prompt=Fix%20the%20login%20redirect
# Resume a known session by id
syntic://resume?session=my-refactorParameters are URL-encoded, so spaces and special characters in a prompt must be percent-escaped. The link opens the interactive TUI by default; add &print=1 to run headlessly and return output.
Generating links
Any tool that can render a hyperlink can offer a “Open in Syntic Code” affordance. Build the URL from the repository path and the prompt text you want to seed:
# Construct a link from a shell script
prompt=$(python3 -c "import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1]))" "Add tests for auth.js")
echo "syntic://session?repo=$PWD&prompt=$prompt"Safety
Because a link can carry an arbitrary prompt, Syntic Code treats deep-link launches as untrusted input. Before executing, it shows you the resolved repository and prompt and asks for confirmation, and it applies your normal permission rules to any tools the session tries to use. Links never bypass authentication or grant elevated access, so a malicious link can at most propose actions you must still approve.