Deep Links

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

New Chat

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

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

Parameters:

Parameter	Description
input	Text to pre-fill in the input field
send	Set to true to immediately send the message
name	Custom name for the session

Workspace Targeting

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

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

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

View Routes

Navigate directly to specific views:

Sessions:

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

Sources:

craftagents://sources
craftagents://sources/source/{sourceSlug}

Skills:

craftagents://skills
craftagents://skills/skill/{skillSlug}

Settings:

craftagents://settings
craftagents://settings/workspace
craftagents://settings/permissions
craftagents://settings/shortcuts
craftagents://settings/preferences

Session Actions

Manage sessions via deep links:

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

Window Modes

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

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

Mode	Description
focused	New focused window
full	New full window

Use Cases

Browser bookmarks

Create bookmarks that launch specific workflows:

• Morning briefing: craftagents://action/new-chat?input=Give%20me%20my%20morning%20briefing&send=true
• Quick task check: craftagents://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](craftagents://action/new-chat?input=How%20does%20the%20auth%20system%20work%3F)

Shell aliases

Create shell aliases for common tasks:

alias morning="open 'craftagents://action/new-chat?input=Morning%20briefing&send=true'"
alias standup="open 'craftagents://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 craftagents:// 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 "craftagents://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.