Advanced 📚
Getting Started 👋
Deep Links (x-scheme-url)
Alice supports internal links that can be used with tools such as Keyboard Maestro or Shortcuts on macOS. You can also link directly to threads or send messages to a specific assistant or skill by opening a properly prepared URL.
The links below allow you to interact with Alice through automation or a browser.
Conversations
alice://conversation/{id}- Open a specific conversation. You can get its ID from the conversation list panel.alice://chat/new- Start a new chatalice://chat/history- Open chat history panelalice://newchatoralice://new-chat- Create new chat (supports query params below)
Assistants
alice://assistant/{id}- Open specific assistant. You can find its ID in the settings, below assistant's namealice://assistant/files/{uuid}- Open assistant files settingsalice://assistant/neworalice://assistant/create- Create new assistantalice://edit/assistant/{id}- Edit specific assistant
Snippets/Skills
alice://snippet/{id}- Open and activate specific skillalice://snippet/new- Create new skillalice://skill/{id}- Alias for snippet (same functionality)alice://skill/new- Create new skill (alias)alice://edit/snippet/{id}- Edit specific snippet
Snippet Query Parameters
?prompt={text} - Send prompt after activating snippet?input={text} - Alias for prompt parameter?new=true - Start new conversation before activating snippet
Examples:
alice://snippet/{id}?prompt=Hello - Activate snippet and send "Hello"
alice://snippet/{id}?new=true - Start fresh thread with snippet active
alice://snippet/{id}?prompt=Hello&new=true - New thread + snippet + message
alice://snippet/{id}- Open specific skill You can find its ID in the settings, below skill's namealice://snippet/create- Create new skillalice://skill/new- Create new snippet (alias)alice://edit/snippet/{id}- Edit specific snippet
Settings
alice://settings/general- General settingsalice://settings/general/shortcuts- Keyboard shortcuts settingsalice://settings/account- Account settingsalice://settings/account/trial- Account settings with trial banner focusalice://settings/application- Application settingsalice://settings/appearance- Appearance settingsalice://settings/connections- AI provider connectionsalice://settings/backup- Backup settingsalice://settings/assistants- Assistants panelalice://settings/snippets- Snippets panelalice://settings/skills- Snippets panel (alias)alice://settings/library- Library panelalice://settings/memory- Memory panelalice://settings/mcp- MCP panel
Query Parameters
New Chat Parameters
?assistant={uuid}- Pre-select assistant?snippet={uuid}- Pre-select snippet?prompt={text}- Pre-fill prompt text?input={text}- Alias for prompt parameter
Window Control
?show=true- Ensure window is visible/active (for import links)
All deeplinks support URL encoding for special characters in parameters.
The links below allow you to interact with Alice through automation or a browser.
Conversations
alice://conversation/{id}- Open a specific conversation. You can get its ID from the conversation list panel.alice://chat/new- Start a new chatalice://chat/history- Open chat history panelalice://newchatoralice://new-chat- Create new chat (supports query params below)
Assistants
alice://assistant/{id}- Open specific assistant. You can find its ID in the settings, below assistant's namealice://assistant/files/{uuid}- Open assistant files settingsalice://assistant/neworalice://assistant/create- Create new assistantalice://edit/assistant/{id}- Edit specific assistant
Snippets/Skills
alice://snippet/{id}- Open and activate specific skillalice://snippet/new- Create new skillalice://skill/{id}- Alias for snippet (same functionality)alice://skill/new- Create new skill (alias)alice://edit/snippet/{id}- Edit specific snippet
Snippet Query Parameters
?prompt={text} - Send prompt after activating snippet?input={text} - Alias for prompt parameter?new=true - Start new conversation before activating snippet
Examples:
alice://snippet/{id}?prompt=Hello - Activate snippet and send "Hello"
alice://snippet/{id}?new=true - Start fresh thread with snippet active
alice://snippet/{id}?prompt=Hello&new=true - New thread + snippet + message
alice://snippet/{id}- Open specific skill You can find its ID in the settings, below skill's namealice://snippet/create- Create new skillalice://skill/new- Create new snippet (alias)alice://edit/snippet/{id}- Edit specific snippet
Settings
alice://settings/general- General settingsalice://settings/general/shortcuts- Keyboard shortcuts settingsalice://settings/account- Account settingsalice://settings/account/trial- Account settings with trial banner focusalice://settings/application- Application settingsalice://settings/appearance- Appearance settingsalice://settings/connections- AI provider connectionsalice://settings/backup- Backup settingsalice://settings/assistants- Assistants panelalice://settings/snippets- Snippets panelalice://settings/skills- Snippets panel (alias)alice://settings/library- Library panelalice://settings/memory- Memory panelalice://settings/mcp- MCP panel
Query Parameters
New Chat Parameters
?assistant={uuid}- Pre-select assistant?snippet={uuid}- Pre-select snippet?prompt={text}- Pre-fill prompt text?input={text}- Alias for prompt parameter
Window Control
?show=true- Ensure window is visible/active (for import links)
All deeplinks support URL encoding for special characters in parameters.
Getting Started 👋
Deep Links (x-scheme-url)
Alice supports internal links that can be used with tools such as Keyboard Maestro or Shortcuts on macOS. You can also link directly to threads or send messages to a specific assistant or skill by opening a properly prepared URL.
The links below allow you to interact with Alice through automation or a browser.
Conversations
alice://conversation/{id}- Open a specific conversation. You can get its ID from the conversation list panel.alice://chat/new- Start a new chatalice://chat/history- Open chat history panelalice://newchatoralice://new-chat- Create new chat (supports query params below)
Assistants
alice://assistant/{id}- Open specific assistant. You can find its ID in the settings, below assistant's namealice://assistant/files/{uuid}- Open assistant files settingsalice://assistant/neworalice://assistant/create- Create new assistantalice://edit/assistant/{id}- Edit specific assistant
Snippets/Skills
alice://snippet/{id}- Open and activate specific skillalice://snippet/new- Create new skillalice://skill/{id}- Alias for snippet (same functionality)alice://skill/new- Create new skill (alias)alice://edit/snippet/{id}- Edit specific snippet
Snippet Query Parameters
?prompt={text} - Send prompt after activating snippet?input={text} - Alias for prompt parameter?new=true - Start new conversation before activating snippet
Examples:
alice://snippet/{id}?prompt=Hello - Activate snippet and send "Hello"
alice://snippet/{id}?new=true - Start fresh thread with snippet active
alice://snippet/{id}?prompt=Hello&new=true - New thread + snippet + message
alice://snippet/{id}- Open specific skill You can find its ID in the settings, below skill's namealice://snippet/create- Create new skillalice://skill/new- Create new snippet (alias)alice://edit/snippet/{id}- Edit specific snippet
Settings
alice://settings/general- General settingsalice://settings/general/shortcuts- Keyboard shortcuts settingsalice://settings/account- Account settingsalice://settings/account/trial- Account settings with trial banner focusalice://settings/application- Application settingsalice://settings/appearance- Appearance settingsalice://settings/connections- AI provider connectionsalice://settings/backup- Backup settingsalice://settings/assistants- Assistants panelalice://settings/snippets- Snippets panelalice://settings/skills- Snippets panel (alias)alice://settings/library- Library panelalice://settings/memory- Memory panelalice://settings/mcp- MCP panel
Query Parameters
New Chat Parameters
?assistant={uuid}- Pre-select assistant?snippet={uuid}- Pre-select snippet?prompt={text}- Pre-fill prompt text?input={text}- Alias for prompt parameter
Window Control
?show=true- Ensure window is visible/active (for import links)
All deeplinks support URL encoding for special characters in parameters.