Aight Utils

Native integration with the Aight iOS app.

Creates reminders, tasks, and tracked items that appear in the user's Aight Today view.

When to Use

Item Types

Usage Examples

Create a Reminder

{
  "id": "remind-dentist-1711123200",
  "type": "trigger",
  "text": "Call dentist to schedule appointment",
  "scheduledFor": "2026-03-23T14:00:00+08:00",
  "labels": ["health", "personal"]
}

Create a Task

{
  "id": "task-bp-draft-1711123200",
  "type": "item",
  "text": "Draft Q2 funding BP",
  "labels": ["work", "fundraising"],
  "status": "active"
}

Create a Deadline

{
  "id": "deadline-tax-1711123200",
  "type": "trigger",
  "text": "File tax return",
  "scheduledFor": "2026-04-15T23:59:59+08:00",
  "type": "deadline",
  "labels": ["finance", "urgent"]
}

Track a PR

{
  "id": "pr-openclaw-123-1711123200",
  "type": "item",
  "text": "Review OpenClaw PR #123",
  "url": "https://github.com/openclaw/openclaw/pull/123",
  "labels": ["code-review"],
  "status": "active"
}

Mark Complete

{
  "id": "task-bp-draft-1711123200",
  "status": "done"
}

ID Generation Rules

• Format: <type>-<slug>-<timestamp>
• Slug: kebab-case, 2-4 words describing the item
• Timestamp: Unix epoch or short hash for uniqueness

Examples:

• remind-groceries-1711123200
• task-bp-draft-1711123200
• deadline-tax-2026q1
• pr-openclaw-123

Labels Convention

Use consistent labels for categorization:

Date Parsing

Parse natural language dates to ISO 8601:

Current time: 2026-03-22 23:45 GMT+8 (Asia/Shanghai)

Rules

1. Always generate unique IDs — use slug + timestamp
2. Parse dates before calling — convert natural language to ISO 8601
3. Set labels for categorization — helps user filter in Today view
4. Default status is "active" — don't set unless changing
5. For reminders: always use type: "trigger" with scheduledFor
6. For tasks: use type: "item" with labels
7. For completions: update existing item with status: "done"

Integration with Other Skills

Error Handling

If item creation fails:

1. Log to .learnings/ERRORS.md
2. Inform user: "Couldn't create reminder — adding to memory instead"
3. Create fallback in memory/YYYY-MM-DD.md

Version: 1.0.0
Author: alex
Last Updated: 2026-03-22