tanasienkoilla9-source/things-cli-magus

---
🌟 Why This Exists: The Cognitive Overload Epidemic
Do you know what happens when you juggle 47 tasks across 12 projects? Your brain doesn't just slow down—it **fractures**. Modern knowledge workers suffer from what neuroscientists call "attention residue": every context switch leaves a mental smudge that costs 23 minutes to fully recover from. **Task Agent** doesn't just manage your to-do list; it erects a **cognitive firewall** between your creative mind and the chaos of execution.
Think of it this way: Things 3 is a beautiful, pristine cathedral for your tasks. But who builds the scaffolding? Who maintains the stained glass? **Task Agent is that silent caretaker**—operating in the terminal shadows, whispering to your SQLite database through AppleScript incantations, ensuring your digital monastery remains in perfect liturgical order.
---
🎯 What Makes This Different From Every Other Task Manager
While most automation tools are like using a sledgehammer to perform brain surgery, **Task Agent** operates with **surgical precision**:
- **Not a wrapper, but a weaver**: Direct SQLite access means we read your data at the speed of light—no GUI overhead, no app-switching latency
- **Multi-model AI orchestration**: Choose between OpenAI's GPT-4 or Claude 3.5 Opus depending on your mood—or let the system **auto-select** based on task complexity
- **Bidirectional intelligence**: Your tasks don't just get automated; they get **recontextualized** through AI lenses that spot dependencies you never noticed
- **Zero learning curve**: If you can type things create "Buy milk", you've already mastered 80% of the interface
---
🏗️ Architecture: The Three Pillars of Automated Tasking
The architecture resembles a **digital nervous system**: your commands (impulses) travel through three parallel pathways, ensuring redundancy and speed. If AppleScript fails, SQLite takes over. If the network drops, local intelligence steps in. This isn't fragile—it's **resilient by design**.
---
🚀 Getting Started in 15 Seconds
Prerequisites
- **Hardware**: Any Mac running macOS 11 Big Sur or later
- **Software**: Things 3 (any version), Python 3.9+, pip
- **Mindset**: Willingness to embrace terminal-as-mind-palette
Installation
After installation, the setup wizard will:
1. 🧠 Scan your current Things 3 database structure
2. 🔑 Prompt for AI API keys (optional—works without them)
3. ⚙️ Create a personalized profile in ~/.task_agent/config.yaml
---
⚙️ Example Profile Configuration
Your profile is the **DNA of your automation**. Here's what a power user's configuration looks like:
This configuration transforms **Task Agent** from a utility into a **personal executive assistant** that learns your rhythms. The temperature parameter is particularly powerful: at 0.1, your AI behaves like a stoic military commander; at 0.8, it suggests creative task relationships you'd never considered.
---
🖥️ Example Console Invocation
Watch how **Task Agent** interprets natural language into precise actions:
Notice the **intelligence cascade**: the system didn't just parse keywords—it understood the relationship between tasks, suggested a project grouping, and even identified the implicit priority level. This is the difference between **command execution** and **intent understanding**.
---
💻 OS Compatibility
| Feature | macOS 11 Big Sur | macOS 12 Monterey | macOS 13 Ventura | macOS 14 Sonoma |
|---------|:----------------:|:-----------------:|:-----------------:|:----------------:|
| AppleScript Bridge | ✅ Full | ✅ Full | ✅ Full | ✅ Full |
| SQLite Direct Access | ✅ Full | ✅ Full | ✅ Full | ✅ Full |
| URL Scheme Routing | ✅ Full | ✅ Full | ✅ Full | ✅ Full |
| Notification Center | ✅ | ✅ | ✅ | ✅ |
| Touch Bar Integration | ✅ Legacy | ✅ | ✅ | ❌ Deprecated |
| Focus Mode Aware | ❌ | ❌ | ✅ | ✅ |
| Stage Manager Compatible | N/A | N/A | ✅ | ✅ |