things-mac

by Unknown v1.0.0

This skill enables interaction with the Things 3 task management application on macOS via the `things` command-line interface. It allows you to add new tasks, update existing ones, search for tasks based on various criteria, and list items from your inbox, today view, upcoming tasks, projects, areas, and tags.

The skill leverages the Things URL scheme for adding and updating tasks and directly reads the local Things database for search and listing operations. This provides a powerful way to automate task management workflows and integrate Things 3 with other tools and services.

Requires the `things3-cli` tool, which can be installed via Go. Full Disk Access may be required for the calling application to access the Things database.

What It Does

Allows OpenClaw to interact with the Things 3 task management application on macOS, enabling the addition, updating, searching, and listing of tasks, projects, areas, and tags.

When To Use

When a user asks OpenClaw to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.

Inputs

Natural language queries for task management operations (add, update, search, list) and Things 3 data such as task titles, notes, due dates, projects, areas, and tags.

Outputs

Task management operations in Things 3, such as adding new tasks, updating existing tasks, listing tasks based on criteria, and search results. The skill also provides information about projects, areas, and tags within Things 3.

Limitations

Requires the `things` CLI to be installed and configured on macOS. Task deletion is not directly supported by the CLI tool. Requires granting full disk access to the calling app for database reads.

Installation

1. Install Go on your macOS system.
2. Install the `things` CLI by running `GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest` in your terminal.
3. Ensure the `things` binary is in your PATH.
4. Grant Full Disk Access to the calling app (Terminal or OpenClaw.app) in System Preferences > Security & Privacy > Full Disk Access.
5. Optionally, set the `THINGSDB` environment variable to point to your `ThingsData-*` folder.
6. Optionally, set the `THINGS_AUTH_TOKEN` environment variable to avoid passing the `--auth-token` flag for update operations.

View Cline documentation

1. Open Claude Desktop app.
2. Open the OpenClaw settings from the menu bar.
3. Paste the content of the SKILL.md file into the "Skills" section.
4. Grant Full Disk Access to OpenClaw.app in System Preferences > Security & Privacy > Full Disk Access.
5. Install the `things` CLI by running `GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest` in your terminal.

View Claude (Anthropic) documentation

Have a Skill to Share?

Join the community and help AI agents learn new capabilities. Submit your skill and reach thousands of developers.