Skip to content

🚀 OFCLI v1.0.1 - The CLI That Respects Your OmniFocus System

Latest
Latest

Choose a tag to compare

View all tags
@jmg421 jmg421 released this 19 Jul 19:23
· 19 commits to main since this release
v1.0.1
7b75729

🎯 The CLI That Respects Your Trusted System

💭 The Story

As the founder of nodes.bio, I wear every hat in the company. Context switching between strategic thinking and operational execution was killing my productivity, even with OmniFocus.

So I built OFCLI for myself with one killer principle: Single Source of Truth

🏆 The Killer Feature: Single Source of Truth

OFCLI never changes your OmniFocus data without your explicit command. It pulls fresh exports, processes them, and presents information - but OmniFocus remains your authoritative system. No sync conflicts, no data corruption, no surprises.

This is the CLI that respects your trusted system.

✅ What Actually Works (Battle-Tested)

Core OmniFocus Integration

  • Fresh Export Guarantee: Always pulls latest data from OmniFocus via AppleScript
  • Real-time Communication: Direct AppleScript integration for commands
  • Schema Validation: Pydantic models ensure data integrity
  • No Data Conflicts: OmniFocus remains your single source of truth

Apple Ecosystem Integration

  • AppleScript Calendar Bridge: Seamless integration with Apple Calendar events
  • EventKit Calendar Access: Native macOS calendar integration without timeouts
  • Native macOS Integration: Built specifically for the Apple ecosystem

Productivity Features

  • Batch Operations: Efficiently manage multiple tasks and projects
  • Advanced Search: Fast, flexible search across all your data
  • Local SQLite Cache: Enhanced querying while respecting OmniFocus as source
  • Rich CLI Output: Beautiful, readable formatting for terminal workflows

🧪 Experimental Features (Use with Caution)

  • AI Task Analysis: Early-stage OpenAI/Anthropic integration for task insights
  • Calendar Conflict Detection: Experimental scheduling awareness
  • Inbox Cleanup Suggestions: AI-powered project categorization (early beta)

🚀 Quick Start

# Clone and install
git clone https://github.com/jmg421/omnifocus-cli.git
cd omnifocus-cli
pip install -e .

# Basic usage (no API keys needed)
ofcli --help
ofcli diagnostics
ofcli list-live-projects

# Optional: Add AI features
echo 'OPENAI_API_KEY=your_key' >> ~/.ofcli.env
ofcli prioritize --limit 5

🎯 Perfect For

  • Solo founders managing startup chaos
  • OmniFocus power users who need command-line efficiency
  • Anyone who's been burned by sync conflicts with other tools
  • Mac users who live in the Apple ecosystem
  • GTD practitioners who want to enhance their trusted system

💝 Community Contribution

This tool literally runs my life and my company. I'm sharing it because the OmniFocus and GTD community gave me the foundation for effective time management.

The combination of OmniFocus + OFCLI + Apple Calendar is how I stay sane while building a startup.

🔧 What's New in v1.0.1

  • Honest feature descriptions (no overpromising)
  • Clear distinction between stable and experimental features
  • Single Source of Truth positioned as the killer feature
  • Simplified setup (API keys now optional)
  • Improved documentation and community focus

Built with ❤️ by a solo founder who lives and breathes OmniFocus

GitHub: https://github.com/jmg421/omnifocus-cli
Website: https://nodes.bio

Assets 2
Loading