---
url: /mod/mac/re.md
---
# x mac re

A CLI for managing Apple Reminders


::: tip
If you encounter permission issues when running for the first time, go to [System Settings] > [Privacy & Security] > [Automation] and grant your terminal app (e.g., Terminal, iTerm, x, Alfred) permission to access the Reminders app.
:::


## Examples

Add a reminder titled "Buy milk" at 6:00 PM on June 25, 2025

```sh
x mac re add "Buy milk" "2025-06-25" "18:00"
```

Mark the reminder titled "Buy milk" as completed

```sh
x mac re comp "Buy milk"
```

Update the reminder "Buy milk" to "Buy milk,egg" and change the time to 7:00 PM on June 25, 2025

```sh
x mac re update "Buy milk" "Buy milk,egg" "2025-06-25 19:00"
```

List all reminders

```sh
x mac re ls
```

Retrieve the detailed information for the reminder named "Buy milk"

```sh
x mac re get "Buy milk"
```

Remove the reminder titled "Buy milk"

```sh
x mac re rm "Buy milk"
```

## Sub Commands

| Name | Description |
| ------- | ------- |
| [x mac re ls](#x-mac-re-ls) | List all reminders |
| [x mac re add](#x-mac-re-add) | Add a new reminder |
| [x mac re comp](#x-mac-re-comp) | Mark a specific reminder as completed |
| [x mac re rm](#x-mac-re-rm) | Remove a specific reminder |
| [x mac re update](#x-mac-re-update) | Update a reminder's title or time |
| [x mac re get](#x-mac-re-get) | Get detailed information of a specific reminder |


### x mac re ls

List all reminders


- **Usage**:

```sh
x mac re ls [FLAGS]
```

- **Flags**:


| Name, Shorthand | Description |
| ------- | ------- |
| `--csv` | Using CSV format |
| `--tsv` | Using TSV format |
| `--json` | Using JSON format |
| `--yml` | Using YAML format |


### x mac re add

Add a new reminder


- **Examples**:

Add a reminder titled "Buy milk" at 6:00 PM on June 25, 2025

```sh
x mac re add "Buy milk" "2025-06-25" "18:00"
```

- **Usage**:

```sh
x mac re add <#1> <#2> <#3>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Reminder title |
| `#2` | Date (e.g. 2025-06-24) |
| `#3` | Time (e.g. 09:30) |


### x mac re comp

Mark a specific reminder as completed


- **Examples**:

Mark the reminder titled "Buy milk" as completed

```sh
x mac re comp "Buy milk"
```

- **Usage**:

```sh
x mac re comp|complete <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Reminder title |


### x mac re rm

Remove a specific reminder


- **Examples**:

Remove the reminder titled "Buy milk"

```sh
x mac re rm "Buy milk"
```

- **Usage**:

```sh
x mac re rm <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Reminder title |


### x mac re update

Update a reminder's title or time


- **Examples**:

Update the reminder "Buy milk" to "Buy milk,egg" and change the time to 7:00 PM on June 25, 2025

```sh
x mac re update "Buy milk" "Buy milk,egg" "2025-06-25 19:00"
```

- **Usage**:

```sh
x mac re update <#1> <#2> <#3>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Original reminder title |
| `#2` | New reminder title |
| `#3` | Date and time (e.g. 2025-06-24 20:30) |


### x mac re get

Get detailed information of a specific reminder


- **Examples**:

Retrieve the detailed information for the reminder named "Buy milk"

```sh
x mac re get "Buy milk"
```

- **Usage**:

```sh
x mac re get <#1>
```

- **Arguments**:


| Argument | Description |
| ------- | ------- |
| `#1` | Reminder title |