Deep Links

Synti registers the synti:// URL scheme, so any app that can open a link can drive Synti. Click a synti:// link in a browser, run one from a shell script, add it to a launcher, or embed it in your notes — Synti comes to the front and performs the action. Deep links are the glue between Synti and the rest of your workflow.

Anatomy of a link

A deep link names an action or a route, followed by optional parameters:

synti://action/new-chat?input=Hello%20world&send=true

Remember to URL-encode parameter values — spaces become %20, and so on.

Starting a chat

The most common link opens a new session.

synti://action/new-chat

It accepts these parameters:

Parameter	Purpose
`input`	Text to pre-fill in the composer
`send`	Set to `true` to submit the message immediately
`name`	A custom name for the new session
`window`	`focused` to reuse the current window, or `full` for the full window

For example, a one-click “summarize my day” bookmark:

synti://action/new-chat?input=Summarize%20today%27s%20flagged%20sessions&send=true&name=Daily%20recap

Acting on a session

Target an existing session by its ID:

synti://action/flag-session/{sessionId}
synti://action/unflag-session/{sessionId}
synti://action/delete-session/{sessionId}
synti://action/rename-session/{sessionId}?name=New%20Name

Navigating the app

Deep links can also jump straight to a view or a resource.

synti://allSessions
synti://flagged
synti://state/{statusId}

synti://sources/source/{sourceSlug}
synti://skills/skill/{skillSlug}

synti://settings/workspace
synti://settings/permissions
synti://settings/shortcuts
synti://settings/preferences

Targeting a workspace

By default a link acts on the current workspace. Prepend a workspace segment to direct it somewhere specific:

synti://workspace/{workspaceId}/action/new-chat?input=Deploy%20checklist&send=true

See Workspaces for where to find a workspace ID.

Where deep links shine

Browser bookmarks

Save a prompt you run often as a one-click bookmark.

Shell aliases

Wrap a link in a shell function or open/xdg-open command.

Launchers

Trigger sessions from Raycast, Alfred, or Spotlight.

Documentation

Embed action links in runbooks and internal notes.

Pair deep links with mobile shortcuts to hand a task to Synti from your phone, or with an Automation to chain actions together.

Workspaces

Scope links to a specific workspace.

Sharing

Publish a conversation as a link.

Getting Started

Core Concepts

Sources

Skills

Browser Automation

Messaging

Labels

Statuses

Customization

Go Further

Anatomy of a link

Starting a chat

Acting on a session

Navigating the app

Targeting a workspace

Where deep links shine

Browser bookmarks

Shell aliases

Launchers

Documentation

Workspaces

Sharing

​Anatomy of a link

​Starting a chat

​Acting on a session

​Navigating the app

​Targeting a workspace

​Where deep links shine

Browser bookmarks

Shell aliases

Launchers

Documentation

​Related

Workspaces

Sharing

Anatomy of a link

Starting a chat

Acting on a session

Navigating the app

Targeting a workspace

Where deep links shine

Related