omnifocus-cli

OmniFocus CLI Skill

Manage OmniFocus tasks using the of CLI bundled in this plugin.

Setup

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.

How to Use

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]

Commands

Inbox

of inbox list                    # List inbox tasks (brief)
of inbox list --detailed         # List with full details

Add Task

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)

Complete Task

of task complete "task-id"

Search Tasks

of task search "keyword"
of task search "review" --project Work --flagged --limit 10

Task Lists

of tasks today      # Due today
of tasks overdue    # Overdue
of tasks flagged    # Flagged

Perspectives

of perspectives list    # List all perspective names

Projects

# 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

Date Formats

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

Output

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"}

Guidelines

• When user says "OF" they mean OmniFocus
• Always use the full path ${CLAUDE_PLUGIN_ROOT}/skills/omnifocus-cli/bin/of to invoke the CLI
• Parse JSON output to present results in a readable format
• When adding tasks, infer appropriate flags from context (e.g. work-related -> --project Work)
• Convert relative date references from user to the CLI date format (e.g. "in 3 days" -> --due +3d)