Craft for Raycast

Search your content, open and add to Daily Notes, and manage Spaces from Raycast. Use @craftdocs in Raycast AI to search, read and write your Craft documents.

Requirements

Craft must be installed (regular or Setapp version).

Features

🔍 Search Blocks

Search Craft's local index from Raycast.

• Search Document titles and Blocks content across enabled Spaces
• Filter by Space or search all
• Open results in Craft
• Create a new Document from the current query
• Optional detail view shows Document previews

📅 Daily Notes

Open Daily Notes in the selected Space.

• Shortcuts for today, yesterday, and tomorrow
• Parse exact dates and natural-language queries like last Monday
• Remembers the last selected Space

✍️ Add to Daily Note

Add content to today's Daily Note without leaving Raycast.

• Targets any enabled Space; defaults to primary
• Optional timestamp with custom format
• Configurable prefix, suffix, and append position
• Always copies content to clipboard for safety
• Appends directly if today's note exists; otherwise opens Craft with content ready to paste

🏷️ Manage Spaces

Manage which Craft Spaces appear in the extension.

• Rename Spaces and copy their IDs
• Enable or disable non-primary Spaces
• Access the tutorial to identify your Spaces by ID

How to determine your Spaces

You only need this once per Space.

1. Open Craft and switch to the Space you want to name
2. Open any Document in that Space
3. Right-click on any Block
4. Choose Copy As → Deeplink

The copied deeplink will look like this:

craftdocs://open?blockId=ABC123&spaceId=1ab23c45-67de-89f0-1g23-hijk456789l0

The Space ID is the value after spaceId=.

Back in Raycast, return to Manage Spaces, find the matching ID, and rename it. You can also use the built-in Copy Space ID action to confirm which entry matches the current Craft Space.

Once you know which ID corresponds to which Space, you can rename them for better organization.

🤖 Raycast AI

Mention @craftdocs in Quick AI or AI Chat to work with Craft in natural language.

• "find my notes about the product launch"
• "what did I write in today's daily note?"
• "add 'ship v2 on Friday' to my Roadmap document"
• "create a document called Meeting Notes"
• "in my Roadmap document, change 'Friday' to 'Monday'" (requires the Craft API)

Tool	Description	Needs Craft API
List Spaces	List Spaces with their IDs and status	No
Search Blocks	Search Documents and Blocks	No
Get Document	Read a Document or Daily Note	No
Create Document	Create a new Document	No
Append to Document	Add content to the beginning or end of a Document	No
Add to Daily Note	Add content to a Daily Note, creating the note if needed	No
Manage Space	Rename, enable or disable a Space	No
Craft API	Edit, delete and move content; manage tasks, collections, folders and more	Yes

Raycast AI asks for confirmation before any tool changes your content.

Commands

Command	Description
Search Blocks	Search indexed Craft content and create Documents
Daily Notes	Open Daily Notes in a selected Space
Add to Daily Note	Copy, append, or open today's Daily Note
Manage Spaces	Rename Spaces and control their visibility

Configuration

Application Selection

If you have multiple versions of Craft installed, choose the app in extension preferences. Supported bundle IDs are the regular Craft app and Craft via Setapp. If left empty, the extension auto-selects the first supported installed app.

Search Preferences

• Detailed View: Switch the view from Block rows to Document rows with a detail pane content preview

Add to Daily Note Preferences

These apply to both the Add to Daily Note command and the AI tool.

• Position: Append content at the beginning or end
• Timestamp: Automatically include current time with each entry
• Time Format: Use patterns like HH:mm (14:30), h:mm A (2:30 PM) or HH:mm:ss (14:30:45)
• Prefix / Suffix: Wrap content with custom text

Craft API (optional)

Craft's URL Scheme can only create Documents and add content. To let Raycast AI edit, delete and move existing content, connect the Craft API:

1. In Craft, open the Imagine tab and create an API connection (space-level access gives the AI access to all Documents)
2. Copy the API URL (https://connect.craft.do/links/.../api/v1) into Craft API URL in the extension preferences
3. If the connection uses an API key, paste it into Craft API Key

Space Management

• Custom Names: Give your Spaces names instead of using Space IDs
• Enable / Disable: Hide unused Spaces from all commands
• Persistent Settings: Names, enabled state, and filter selections are shared across all commands

How It Works

The extension reads Craft's local container data to discover Spaces and uses Craft's local SQLite search index for Search Blocks and Daily Note lookup. Search is offline and limited to Spaces that are both synced locally in Craft and enabled in the extension.

The extension uses Craft's URL Scheme for Document creation, note opening, and appending content. When the optional Craft API is configured, the Craft API AI tool uses it to edit, delete and move content.

Troubleshooting

Search Results Not Appearing

Open the selected Craft app once so it can create its local data directory, then let it finish syncing. Search Blocks only works when Craft's local search index exists. Disabled Spaces are intentionally hidden from results.

Add to Daily Note Opens Craft Instead of Appending

This is expected when today's Daily Note cannot be found in the local Craft search database. The command still copies the formatted content, then opens today's Daily Note so you can paste it manually.

AI Can't Edit or Delete Content

Editing existing content requires the Craft API. Add the Craft API URL in the extension preferences (see Craft API).

Multiple Craft Versions

If you have both regular and Setapp versions installed, specify your preferred version in the extension preferences under "Application to search in", or leave the preference empty to let the extension auto-detect a supported install.

Performance Issues

The extension performs best when Craft has finished syncing. Large Document collections may take a moment to index initially.

Space Management Issues

If no Spaces appear, open Craft first and wait for sync. If names or enabled state look wrong after upgrading, the extension will try to migrate legacy Space settings from Craft's container into Raycast support storage automatically.

Previous Developer / Maintainer

This extension was originally developed by Vitaliy Kudryk and is currently maintained by Samuel François.

Disclaimer

This project is not affiliated, associated, authorized or in any way officially connected with Craft Docs. The official website can be found at https://www.craft.do. "Craft Docs" as well as related names, marks, emblems and images are registered trademarks of their respective owners.