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

User Says	Create Type	Example
"Remind me to..."	`trigger`	`scheduledFor: ISO 8601`
"Don't forget..."	`trigger`	`scheduledFor: ISO 8601`
"Add this to my tasks"	`item`	`labels: ["category"]`
"Deadline is..."	`trigger`	`type: "deadline"`
"Track this PR/issue"	`item`	`url: "<link>"`
"Done" / "Cancel"	Update status	`status: "done"/"cancelled"`

Item Types

Type	Use For	Key Fields
`trigger`	Time-based, fire-once	`scheduledFor` (ISO 8601)
`item`	Stateful, lifecycle	`labels`, `status`
`process`	Background work	`sessionTarget`, `label`

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:

Category	Labels
Work	`work`, `meeting`, `code-review`, `fundraising`
Personal	`personal`, `health`, `family`
Finance	`finance`, `tax`, `billing`
Urgency	`urgent`, `high-priority`

Date Parsing

Parse natural language dates to ISO 8601:

User Input	ISO 8601
"tomorrow at 2pm"	`2026-03-23T14:00:00+08:00`
"next Friday"	`2026-03-27T09:00:00+08:00`
"end of day"	`2026-03-22T23:59:59+08:00`
"in 2 hours"	`2026-03-22T17:30:00+08:00`

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

Rules

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

Integration with Other Skills

Skill	Integration Point
`proactive-agent`	Outcome tracking → create deadline triggers
`memory-manager`	Important events → create reminder triggers
`watchdog`	Task completion → update item status

Error Handling

If item creation fails:

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

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

aight-utils

Safety Notice

Copy this and send it to your AI assistant to learn