Deep Links

Launch xiantong from anywhere using the xiantong:// URL scheme

The xiantong:// URL scheme lets you launch xiantong directly from browsers, scripts, documentation, or other apps.

New Chat#

Create a new chat session, optionally with pre-filled input:

xiantong://action/new-chat
xiantong://action/new-chat?input=Hello%20world
xiantong://action/new-chat?input=Hello%20world&send=true
xiantong://action/new-chat?input=Hello%20world&name=My%20Chat

Parameters:

Workspace Targeting#

Target a specific workspace by adding the workspace ID to the path:

xiantong://workspace/{workspaceId}/action/new-chat
xiantong://workspace/{workspaceId}/action/new-chat?input=Hello&send=true
xiantong://workspace/{workspaceId}/allSessions

Without workspace targeting, deep links use the currently focused window.

View Routes#

Navigate directly to specific views: Sessions:

xiantong://allSessions
xiantong://allSessions/session/{sessionId}
xiantong://flagged
xiantong://flagged/session/{sessionId}
xiantong://state/{statusId}
xiantong://state/{statusId}/session/{sessionId}

Sources:

xiantong://sources
xiantong://sources/source/{sourceSlug}

Skills:

xiantong://skills
xiantong://skills/skill/{skillSlug}

Settings:

xiantong://settings
xiantong://settings/workspace
xiantong://settings/permissions
xiantong://settings/shortcuts
xiantong://settings/preferences

Session Actions#

Manage sessions via deep links:

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

Window Modes#

Open links in a new window instead of the current one:

xiantong://action/new-chat?window=focused
xiantong://allSessions?window=full

Use Cases#

Browser bookmarks

Create bookmarks that launch specific workflows:

• Morning briefing: xiantong://action/new-chat?input=Give%20me%20my%20morning%20briefing&send=true
• Quick task check: xiantong://action/new-chat?input=What%20are%20my%20top%203%20priorities%3F&send=true

Documentation links

Add links in your team docs that open agent conversations:

[Ask the assistant](xiantong://action/new-chat?input=How%20does%20the%20auth%20system%20work%3F)

Shell aliases

Create shell aliases for common tasks:

alias morning="open 'xiantong://action/new-chat?input=Morning%20briefing&send=true'"
alias standup="open 'xiantong://action/new-chat?input=Prepare%20my%20standup%20notes&send=true'"

Raycast / Alfred shortcuts

Configure launcher apps to trigger workflows with keyboard shortcuts using the deep link URLs.

iOS Shortcuts

On iOS, create Shortcuts that open deep links:

1. Create a new Shortcut
2. Add “Open URL” action
3. Enter your xiantong:// deep link
4. Run from the Shortcuts widget or Siri

Tips#

URL encode your input

When creating deep links with input text, URL-encode special characters:

• Space → %20
• Question mark → %3F
• Ampersand → %26
• Newline → %0A

Test deep links in Terminal

Test your deep links before sharing:

open "xiantong://action/new-chat?input=Hello%20world"

Auto-send for quick workflows

Add &send=true to immediately execute the prompt without manual confirmation - great for automated workflows.