omnifocus

# OmniFocus

Control OmniFocus via JXA (JavaScript for Automation).

## Requirements

- macOS with OmniFocus 3 or 4 installed
- OmniFocus must be running (or will auto-launch)

## Quick Reference

```bash
# Run via the wrapper script
./scripts/of <command> [args...]

# Or directly
osascript -l JavaScript ./scripts/omnifocus.js <command> [args...]
```

## Commands

### List/Query

| Command | Description |
|---------|-------------|
| `inbox` | List inbox tasks |
| `folders` | List all folders |
| `projects [folder]` | List projects, optionally filtered by folder |
| `tasks <project>` | List tasks in a project |
| `tags` | List all tags |
| `today` | Tasks due today or overdue |
| `flagged` | Flagged incomplete tasks |
| `search <query>` | Search tasks by name |
| `info <taskId>` | Full task details |

### Create

| Command | Description |
|---------|-------------|
| `add <name> [project]` | Add task to inbox or project |
| `newproject <name> [folder]` | Create project |
| `newfolder <name>` | Create top-level folder |
| `newtag <name>` | Create or get tag |

### Modify

| Command | Description |
|---------|-------------|
| `complete <taskId>` | Mark complete |
| `uncomplete <taskId>` | Mark incomplete |
| `delete <taskId>` | Permanently delete |
| `rename <taskId> <name>` | Rename task |
| `note <taskId> <text>` | Append to note |
| `setnote <taskId> <text>` | Replace note |
| `defer <taskId> <date>` | Set defer date (YYYY-MM-DD) |
| `due <taskId> <date>` | Set due date |
| `flag <taskId> [true\|false]` | Set flagged |
| `tag <taskId> <tag>` | Add tag (creates if needed) |
| `untag <taskId> <tag>` | Remove tag |
| `move <taskId> <project>` | Move to project |

### Repeat

```bash
# repeat <taskId> <method> <interval> <unit>
of repeat abc123 fixed 1 weeks
of repeat abc123 due-after-completion 2 days
of repeat abc123 defer-after-completion 1 months
of unrepeat abc123
```

Methods: `fixed`, `due-after-completion`, `defer-after-completion`  
Units: `days`, `weeks`, `mont...