Agent Skills › spinabot/brigade › things-mac

things-mac

GitHub

在macOS上通过things CLI管理Things 3应用。支持从本地数据库读取收件箱、今日任务等，或通过URL方案添加、更新任务（如标题、笔记、标签、截止日期）。

skills/things-mac/SKILL.md spinabot/brigade

触发场景

添加新任务到Things 列出或搜索任务/项目修改现有任务的属性

安装

npx skills add spinabot/brigade --skill things-mac -g -y

更多选项

不安装直接使用

npx skills use spinabot/brigade@things-mac

指定 Agent (Claude Code)

npx skills add spinabot/brigade --skill things-mac -a claude-code -g -y

安装 repo 全部 skill

npx skills add spinabot/brigade --all -g -y

预览 repo 内 skill

npx skills add spinabot/brigade --list

SKILL.md

Frontmatter

{
    "name": "things-mac",
    "homepage": "https:\/\/github.com\/ossianhempel\/things3-cli",
    "metadata": {
        "brigade": {
            "os": [
                "darwin"
            ],
            "emoji": "✅",
            "install": [
                {
                    "id": "go",
                    "bins": [
                        "things"
                    ],
                    "kind": "go",
                    "label": "Install things3-cli (go)",
                    "module": "github.com\/ossianhempel\/things3-cli\/cmd\/things@latest"
                }
            ],
            "requires": {
                "bins": [
                    "things"
                ]
            }
        }
    },
    "description": "Manage Things 3 via the `things` CLI on macOS (add\/update projects+todos via URL scheme; read\/search\/list from the local Things database). Use when a user asks Brigade to add a task to Things, list inbox\/today\/upcoming, search tasks, or inspect projects\/areas\/tags."
}

Things 3 CLI

Use things to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.

Setup

Install (recommended, Apple Silicon): GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
If DB reads fail: grant Full Disk Access to the calling app (Terminal for manual runs; Brigade.app for gateway runs).
Optional: set THINGSDB (or pass --db) to point at your ThingsData-* folder.
Optional: set THINGS_AUTH_TOKEN to avoid passing --auth-token for update ops.

Read-only (DB)

things inbox --limit 50
things today
things upcoming
things search "query"
things projects / things areas / things tags

Write (URL scheme)

Prefer safe preview: things --dry-run add "Title"
Add: things add "Title" --notes "..." --when today --deadline 2026-01-02
Bring Things to front: things --foreground add "Title"

Examples: add a todo

Basic: things add "Buy milk"
With notes: things add "Buy milk" --notes "2% + bananas"
Into a project/area: things add "Book flights" --list "Travel"
Into a project heading: things add "Pack charger" --list "Travel" --heading "Before"
With tags: things add "Call dentist" --tags "health,phone"
Checklist: things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"
From STDIN (multi-line => title + notes):
- cat <<'EOF' | things add -
- Title line
- Notes line 1
- Notes line 2
- EOF

Examples: modify a todo (needs auth token)

First: get the ID (UUID column): things search "milk" --limit 5
Auth: set THINGS_AUTH_TOKEN or pass --auth-token <TOKEN>
Title: things update --id <UUID> --auth-token <TOKEN> "New title"
Notes replace: things update --id <UUID> --auth-token <TOKEN> --notes "New notes"
Notes append/prepend: things update --id <UUID> --auth-token <TOKEN> --append-notes "..." / --prepend-notes "..."
Move lists: things update --id <UUID> --auth-token <TOKEN> --list "Travel" --heading "Before"
Tags replace/add: things update --id <UUID> --auth-token <TOKEN> --tags "a,b" / things update --id <UUID> --auth-token <TOKEN> --add-tags "a,b"
Complete/cancel (soft-delete-ish): things update --id <UUID> --auth-token <TOKEN> --completed / --canceled
Safe preview: things --dry-run update --id <UUID> --auth-token <TOKEN> --completed

Delete a todo?

Not supported by things3-cli right now (no “delete/move-to-trash” write command; things trash is read-only listing).
Options: use Things UI to delete/trash, or mark as --completed / --canceled via things update.

Notes