From omnifocus-cli
Manage OmniFocus tasks via CLI. Add, complete, search tasks. List inbox, today, overdue, flagged tasks. List perspectives and manage projects. Use when the user mentions OmniFocus, OF, tasks, inbox, or wants to manage their task list.
How this skill is triggered — by the user, by Claude, or both
Slash command
/omnifocus-cli:omnifocus-cliThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Manage OmniFocus tasks using the `of` CLI bundled in this plugin.
Manage OmniFocus tasks using the of CLI bundled in this plugin.
The CLI is at ${CLAUDE_PLUGIN_ROOT}/skills/omnifocus-cli/bin/of. All commands are self-contained (JXA scripts included in the single bundle).
Requirements: macOS, OmniFocus 4 Pro, Node.js >= 20, optional jq for pretty-printed JSON.
CRITICAL: All commands MUST be run with dangerouslyDisableSandbox: true in the Bash tool.
This CLI uses osascript (JXA) to communicate with OmniFocus, which requires macOS automation permissions that are blocked by the sandbox. Without disabling the sandbox, commands will fail with a misleading error ("アプリケーションは実行されていません") even when OmniFocus is running.
Run commands via Bash tool:
${CLAUDE_PLUGIN_ROOT}/skills/omnifocus-cli/bin/of <command> [arguments]
of inbox list # List inbox tasks (brief)
of inbox list --detailed # List with full details
of task add "Task name"
of task add "Review PR" --project Work --due tomorrow --flagged
of task add "Write report" --due "+3d" --defer today --note "Q1 summary" --estimate 60
of task add "Deploy" --tag urgent --tag ops
Options:
--project <name> -- Assign to project--due <date> -- Due date--defer <date> -- Defer date--flagged -- Mark as flagged--note <text> -- Add a note--estimate <minutes> -- Estimated duration--tag <name> -- Add tag (repeatable)of task complete "task-id"
of task search "keyword"
of task search "review" --project Work --flagged --limit 10
of tasks today # Due today
of tasks overdue # Overdue
of tasks flagged # Flagged
of perspectives list # List all perspective names
# List projects
of projects list # All projects
of projects list --status active # Filter by status
of projects list --folder "Work" # Filter by folder
# Show project details
of projects show "My Project" # Brief info
of projects show "My Project" --detailed # Full details
of projects show "My Project" --tasks # Include tasks
# Create a project
of projects add "New Project"
of projects add "Work Project" --folder "Work" --due "next week" --sequential
of projects add "Side Project" --tag dev --tag personal --flagged
# Change project status
of projects status "Old Project" done
of projects status "Paused Project" on-hold
Status values: active, on-hold, done, dropped
| Format | Example | Description |
|---|---|---|
today | --due today | Today at 17:00 |
tomorrow | --due tomorrow | Tomorrow at 17:00 |
next week | --due "next week" | 7 days from now |
+Nd | --due +3d | N days from now |
+Nw | --due +2w | N weeks from now |
| ISO 8601 | --due 2026-03-15 | Specific date |
All commands return JSON. Parse with jq if needed.
{"success": true, "tasks": [...], "totalCount": 5}
{"success": true, "task": {"id": "abc123", "name": "Buy milk"}}
{"success": true, "projects": [...], "totalCount": 3}
{"success": true, "perspectives": ["Inbox", "Forecast", ...]}
{"success": false, "error": "OmniFocus is not running"}
${CLAUDE_PLUGIN_ROOT}/skills/omnifocus-cli/bin/of to invoke the CLI--project Work)--due +3d)Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub cnosuke/omnifocus-cli --plugin omnifocus-cli