Installing Drafts Actions
These actions must be installed in Drafts before the drafts-manager skill can work.
Quick Install
Geoffrey Export Inbox
- Open Drafts on your Mac
- Go to Drafts → Settings → Actions → Manage Actions
- Click the + button to create a new action
- Set the name to:
Geoffrey Export Inbox - Click Steps → Add Script step
- Copy the entire contents of
geoffrey-export-inbox.jsinto the script editor - Click Done to save
Geoffrey Process Draft
- Create another new action
- Set the name to:
Geoffrey Process Draft - Click Steps → Add Script step
- Copy the entire contents of
geoffrey-process-draft.jsinto the script editor - Important: Click the gear icon on the action and set:
- After Success: Do Nothing (don't archive the draft - the script handles this)
- Click Done to save
Verification
Test that the export action works:
open "drafts://x-callback-url/runAction?action=Geoffrey%20Export%20Inbox"
Check for the export file:
ls -la ~/Library/Mobile\ Documents/iCloud~com~agiletortoise~Drafts5/Documents/geoffrey-export.json
If the file exists and was recently modified, the action is working.
Troubleshooting
"Action not found" error
- Make sure the action names match exactly:
Geoffrey Export InboxGeoffrey Process Draft
- Check for extra spaces or different capitalization
Export file not created
- Open Drafts manually and run the action from the action list
- Check for script errors in Drafts' action log
OmniFocus tasks not created
- Make sure OmniFocus is running
- The OmniFocus URL scheme needs the app to be open
Obsidian notes not created
- Make sure Obsidian is running
- Verify the vault name is "Personal_Notes"
- Check that the folder path exists
Action Configuration
Template Tags
The process action uses Drafts template tags to receive parameters. When called via URL:
drafts://x-callback-url/runAction?action=Geoffrey%20Process%20Draft&uuid=ABC&destination=omnifocus
The parameters become available as template tags in the script.
Customization
To change the Obsidian vault path, edit this line in geoffrey-process-draft.js:
let obsidianVault = "/Users/hagelk/Library/Mobile Documents/iCloud~md~obsidian/Documents/Personal_Notes";
To change the default Obsidian folder, edit:
let folder = draft.getTemplateTag("folder") || "Geoffrey/Inbox";
URL Scheme Reference
Export
drafts://x-callback-url/runAction?action=Geoffrey%20Export%20Inbox
Process to OmniFocus
drafts://x-callback-url/runAction?action=Geoffrey%20Process%20Draft&uuid=UUID&destination=omnifocus&project=Project&tags=Tag1,Tag2&dueDate=2025-11-30
Process to Obsidian
drafts://x-callback-url/runAction?action=Geoffrey%20Process%20Draft&uuid=UUID&destination=obsidian&folder=Meetings
Archive
drafts://x-callback-url/runAction?action=Geoffrey%20Process%20Draft&uuid=UUID&destination=archive
Trash
drafts://x-callback-url/runAction?action=Geoffrey%20Process%20Draft&uuid=UUID&destination=trash