← 返回 Skills 市场
cs995279497-byte

Chen Things Mac

作者 cs995279497-byte · GitHub ↗ · v1.0.0 · MIT-0
darwin ✓ 安全检测通过
162
总下载
1
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install chen-things-mac
功能描述
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 as...
使用说明 (SKILL.md)

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; Clawdbot.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 \x3C\x3C'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 \x3CTOKEN>
  • Title: things update --id \x3CUUID> --auth-token \x3CTOKEN> "New title"
  • Notes replace: things update --id \x3CUUID> --auth-token \x3CTOKEN> --notes "New notes"
  • Notes append/prepend: things update --id \x3CUUID> --auth-token \x3CTOKEN> --append-notes "..." / --prepend-notes "..."
  • Move lists: things update --id \x3CUUID> --auth-token \x3CTOKEN> --list "Travel" --heading "Before"
  • Tags replace/add: things update --id \x3CUUID> --auth-token \x3CTOKEN> --tags "a,b" / things update --id \x3CUUID> --auth-token \x3CTOKEN> --add-tags "a,b"
  • Complete/cancel (soft-delete-ish): things update --id \x3CUUID> --auth-token \x3CTOKEN> --completed / --canceled
  • Safe preview: things --dry-run update --id \x3CUUID> --auth-token \x3CTOKEN> --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

  • macOS-only.
  • --dry-run prints the URL and does not open Things.
安全使用建议
This skill appears to do what it says, but review before installing: 1) Verify the GitHub repository and owner (and the mismatched ownerId in metadata) before running `go install` from @latest — prefer a pinned release/commit. 2) Be cautious about granting Full Disk Access to the agent gateway app (Clawdbot.app): that permission is broad and can expose other files; only grant it if you trust the agent host. 3) Treat THINGS_AUTH_TOKEN as sensitive — provide it only when necessary and consider using short-lived tokens if supported. 4) Use `things --dry-run` for write operations to preview actions. 5) If you want lower risk, install and run the CLI manually yourself rather than letting the skill auto-install/compile it.
功能分析
Type: OpenClaw Skill Name: chen-things-mac Version: 1.0.0 The skill is a legitimate wrapper for the 'things3-cli' tool, designed to manage the Things 3 task manager on macOS. It provides standard instructions for installation via Go and usage examples for reading and updating tasks. While it notes the requirement for Full Disk Access, this is a documented necessity for any tool to read the local Things SQLite database on macOS, and no evidence of malicious intent, data exfiltration, or prompt injection was found in SKILL.md or _meta.json.
能力评估
Purpose & Capability
Name/description match the actions in SKILL.md: it uses the local `things` CLI to read the Things DB and to add/update items via the URL scheme. The install spec (go module github.com/ossianhempel/things3-cli) and required binary `things` are appropriate. Minor metadata inconsistency: the registry metadata ownerId differs from the _meta.json ownerId, and the skill source is listed as unknown even though the SKILL.md points to a GitHub repo — worth verifying.
Instruction Scope
Runtime instructions are focused on running the `things` CLI and are otherwise narrow (no network endpoints). However, they explicitly advise granting Full Disk Access to the calling app (Terminal or `Clawdbot.app`) to read the local Things database; Full Disk Access is a broad, system-level privilege that can expose other user files. SKILL.md also references optional env vars (THINGSDB, THINGS_AUTH_TOKEN) that are not declared in requires.env.
Install Mechanism
Install uses `go install github.com/ossianhempel/things3-cli/...@latest` which will fetch and compile code from GitHub. This is a common distribution method for Go tools but carries moderate risk compared with vetted packages/releases because it pulls remote source (and uses @latest instead of a pinned version). Recommend verifying the repository and using a pinned release/commit.
Credentials
The skill does not require any credentials in registry metadata, which matches most of the SKILL.md. It does mention an optional THINGS_AUTH_TOKEN for write/update operations; that token grants modification ability and should be treated as sensitive. No unrelated credentials are requested. The bigger proportionality issue is the Full Disk Access request (system permission rather than an env var) which is broader than just reading a single app database.
Persistence & Privilege
always is false and the skill does not request persistent or system-wide configuration changes. It does not modify other skills' configs or request elevated/invisible persistence.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install chen-things-mac
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /chen-things-mac 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release for managing Things 3 via the `things` CLI on macOS. - Supports adding and updating tasks, projects, and todos through the Things URL scheme. - Allows reading, listing, and searching from the local Things database (inbox, today, upcoming, projects, areas, tags). - Provides detailed setup instructions and authentication options. - Read (DB) and write (URL scheme) operations clarified, with example commands included. - Requires macOS and the `things` CLI.
元数据
Slug chen-things-mac
版本 1.0.0
许可证 MIT-0
累计安装 1
当前安装数 0
历史版本数 1
常见问题

Chen Things Mac 是什么?

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 as... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 162 次。

如何安装 Chen Things Mac?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install chen-things-mac」即可一键安装,无需额外配置。

Chen Things Mac 是免费的吗?

是的,Chen Things Mac 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Chen Things Mac 支持哪些平台?

Chen Things Mac 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin)。

谁开发了 Chen Things Mac?

由 cs995279497-byte(@cs995279497-byte)开发并维护,当前版本 v1.0.0。

💬 留言讨论