← Back to Skills Marketplace
cs995279497-byte

Chen Things Mac

by cs995279497-byte · GitHub ↗ · v1.0.0 · MIT-0
darwin ✓ Security Clean
162
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install chen-things-mac
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 as...
README (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.
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
✓ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install chen-things-mac
  3. After installation, invoke the skill by name or use /chen-things-mac
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug chen-things-mac
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 162 downloads so far.

How do I install Chen Things Mac?

Run "/install chen-things-mac" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Chen Things Mac free?

Yes, Chen Things Mac is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Chen Things Mac support?

Chen Things Mac is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin).

Who created Chen Things Mac?

It is built and maintained by cs995279497-byte (@cs995279497-byte); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments