omnifocus

Manage OsloFocus 4 tasks and projects via AppleScript commands on macOS.

1|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/n0rvyn/indie-toolkit --skill omnifocus-n0rvyn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omnifocus
Source: https://github.com/n0rvyn/indie-toolkit/tree/main/mactools/skills/omnifocus
Command: npx skills add https://github.com/n0rvyn/indie-toolkit --skill omnifocus-n0rvyn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Provides a direct, scriptable bridge to OmniFocus 4 on macOS so users can inspect and manipulate their tasks and projects without manual UI interaction, removing friction from daily reviews and quick-capture workflows.

Core Features & Use Cases

  • List and Review: Show status overview, inbox, flagged items, due tasks, and project/task lists for daily and weekly reviews.
  • Create and Update: Add tasks to the inbox or projects with context, notes, due/defer dates, and repetition rules.
  • Manage Structure: Create projects and folders, list and activate perspectives, and set or clear task contexts and dates for focused, context-based work.

Quick Start

Add a task to my OmniFocus inbox titled Buy milk due tomorrow with context Errands.

Frequently Asked Questions about omnifocus

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage OmniFocus tasks from the command line on macOS?

You can manage OmniFocus tasks from the command line using osascript-invoked AppleScript commands. This allows you to list, create, complete, and update tasks directly without manual UI interaction.

Can I add tasks to OmniFocus 4 with due dates and contexts via CLI?

Yes, you can add tasks to the inbox or specific projects via CLI. The script parses natural language dates and allows you to set contexts, notes, due dates, defer dates, and repetition rules.

Does this task management CLI require OmniFocus 4 running on macOS?

Yes, this CLI requires OmniFocus 4 actively running on macOS. It uses osascript to invoke AppleScript commands through the included omnifocus_cli.py script to perform task operations.

What is the best way to automate daily and weekly task reviews in OmniFocus?

Automating OmniFocus reviews is best done by scripting status overviews, flagged items, and due tasks. This script provides direct access to list tasks, projects, and perspectives for review workflows.

Can I create and manage OmniFocus projects, folders, and perspectives using AppleScript?

Yes, you can manage structural elements like projects and folders via AppleScript. The script supports listing and activating perspectives, creating projects, and setting task contexts for focused work.

How do I parse natural language dates when creating tasks in OmniFocus?

Parsing natural language dates for OmniFocus tasks is handled by the included omnifocus_cli.py script. It interprets phrases like "due tomorrow" and applies them to your task creation commands.