Things3

Files (9)

• SKILL.md
• add-todo
• get-areas
• get-project
• get-projects
• get-todo
• set-todo
• test-applescript
• things_spec.md

SKILL.md (first lines)

## What I do

This skill provides scripts to interact with Things3 (task management application)
and retrieve data in CSV format.

### Available Scripts

**Get Areas** - Retrieve areas from Things3 with optional filtering.

```bash
~/.config/opencode/skill/things/get-areas [ids=id1,id2] [name=searchterm] [tags=tag1,tag2]
```

**Get Projects** - Retrieve projects from Things3 with optional filtering.

```bash
~/.config/opencode/skill/things/get-projects [ids=id1,id2] [name=searchterm] [area_ids=aid1,aid2] [tags=tag1,tag2]
```

**Get Project** - Retrieve detailed information for a single project by ID, including
all to-dos/items within the project.

```bash
~/.config/opencode/skill/things/get-project <project_id>
```

**Get To-do** - Retrieve detailed information for a single to-do by ID.

```bash
~/.config/opencode/skill/things/get-todo <todo_id>
```

**Set To-do** - Update a to-do's properties (name, status, notes, and/or tags).

```bash
~/.config/opencode/skill/things/set-todo <todo_id> [name=...] [status=...] [notes=...] [tag_names=...]
```

## When to use me

Use me when you need to work with the Things3 Tasks application (aka Things). This
skill allows you to interact with Things3 to retrieve and filter your areas and
projects.

## Filter Options

All filters are optional and can be combined. Multiple filters use **AND** logic
(must match all), while values within a filter use **OR** logic (match any).

### get-areas Filters

- **`ids`** - Comma-delimited area IDs (whitespace trimmed)
  - Example: `ids=RnYsrXCAB2VZCvqkKBeVty` or `ids="id1, id2, id3"`

- **`name`** - Case-insensitive substring search in area name
  - Example: `name=work` or `name="Personal Projects"`

- **`tags`** - Comma-delimited tag names (whitespace trimmed, exact match)
  - Example: `tags="Work: Provider Nexus"` or `tags="tag1, tag2"`

### get-projects Filters

- **`ids`** - Comma-delimited project IDs (whitespace trimmed)
  - Example: `ids=2SwCCY2WDAKqksu6oufbwb` or `ids="id1, id2, id3"`

- **`name`** - Case-insensitive substring search in project name
  - Example: `name=camera` or `name="ops prime"`

- **`area_ids`** - Comma-delimited area IDs (whitespace trimmed)
  - Example: `area_ids=K9U3dAEXnchmJTTCQLput5` or `area_ids="aid1, aid2"`

- **`tags`** - Comma-delimited tag names (whitespace trimmed, exact match)
  - Example: `tags="Important"` or `tags="tag1, tag2"`

### set-todo Parameters

**Required:**

- **`<todo_id>`** - The to-do ID (first positional argument)

**Optional (at least one required):**

- **`name="new name"`** - Update the to-do name
- **`status=open|completed|cancelled`** - Update status (must be one of these three
  values)
- **`notes="note text"`** - Update notes
- **`tag_names="tag1; tag2; tag3"`** - Set tags (semicolon-separated, replaces all
  existing tags)

## Examples

### Get Areas

```bash
# Get all areas
~/.config/opencode/skill/things/get-areas

# Get specific area by ID
~/.config/opencode/skill/things/get-areas ids=RnYsrXCAB2VZCvqkKBeVty

# Get multiple areas by ID
~/.config/opencode/skill/things/get-areas ids="RnYsrXCAB2VZCvqkKKBeVty, K9U3dAEXnchmJTTCQLput5"

# Search areas by name
~/.config/opencode/skill/things/get-areas name=work

# Filter by tags
~/.config/opencode/skill/things/get-areas tags="Work: Provider Nexus"

# Combine filters (AND logic)
~/.config/opencode/skill/things/get-areas name=work tags="Work: Provider Nexus"
```

### Get Projects

```bash
# Get all projects (may be slow with many projects)
~/.config/opencode/skill/things/get-projects

From chaddm/ad-astra-per-aspera, MIT.

More from chaddm/ad-astra-per-aspera