Skip to main content
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:
ParameterDescription
inputText to pre-fill in the input field
sendSet to true to immediately send the message
nameCustom 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
ModeDescription
focusedNew focused window
fullNew full window

​
Use Cases

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
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'"
Configure launcher apps to trigger workflows with keyboard shortcuts using the deep link URLs.
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

When creating deep links with input text, URL-encode special characters:
  • Space → %20
  • Question mark → %3F
  • Ampersand → %26
  • Newline → %0A
Add &send=true to immediately execute the prompt without manual confirmation - great for automated workflows.