← Back to Skills Marketplace
204
Downloads
0
Stars
0
Active Installs
9
Versions
Install in OpenClaw
/install things-plus
Description
Personal task manager powered by Things 3. Trigger when the user asks to add, capture, review, organize, reprioritize, search, or manage tasks in Things. Als...
Usage Guidance
This skill appears to do what it says: it uses the Things 3 CLI and an auth token to manage tasks. Before installing/using it: 1) Confirm you trust the Homebrew tap (ossianhempel) referenced in the setup steps—installing from third‑party taps carries more risk than official repos. 2) Do not paste your THINGS_AUTH_TOKEN into chat; follow the skill's guidance to set it in your environment (it explicitly tells the agent to run things auth to check). 3) Be aware the agent will run local commands that can add/update/delete items in your Things database; the skill documents safeguards (use UUIDs, read-back verification, retries) but you should run initial actions on disposable/test items to confirm behavior. 4) Only grant Full Disk Access to the calling app if absolutely necessary and you understand the implications. If you want extra caution, test the skill in a restricted account or with a test Things database before enabling it for real personal data.
Capability Analysis
Type: OpenClaw Skill
Name: things-plus
Version: 1.2.1
The skill is a functional integration for the Things 3 task manager on macOS, utilizing the legitimate 'things' CLI (ossianhempel/tap/things3-cli). It provides detailed instructions for task lifecycle management, including deduplication, scheduling, and automated title rewriting to improve task actionability. While it requests high-privilege access (Full Disk Access and environment variable configuration for THINGS_AUTH_TOKEN), these are standard requirements for local database interaction and CLI authentication in the Things 3 ecosystem, and no evidence of data exfiltration or malicious intent was found in SKILL.md or the associated test files.
Capability Assessment
Purpose & Capability
Name/description (Things 3 task manager) matches the declared requirement of the 'things' CLI and a THINGS_AUTH_TOKEN primary credential. No unrelated services or credentials are requested.
Instruction Scope
SKILL.md instructs using the 'things' CLI and macOS tooling (mdfind, shell inspection) to read/write tasks, verify auth, and verify writes by read-back. It does suggest reading execution context (echo $SHELL) and advising edits to shell environment files for setting THINGS_AUTH_TOKEN, which is reasonable for this integration and explicitly avoids asking the user to paste tokens into chat.
Install Mechanism
The skill is instruction-only (no install spec). The setup recommends installing via a third‑party Homebrew tap (ossianhempel/tap/things3-cli). That is expected for a CLI wrapper but is a modest risk if you don't trust that tap; the skill itself does not automatically download or execute remote code.
Credentials
Only the THINGS_AUTH_TOKEN credential is declared as primary. The SKILL.md references only that token and the local shell context; it does not request unrelated secrets or other service credentials.
Persistence & Privilege
always is false and the skill is user-invocable; it does not request permanent/system-wide changes. It may perform destructive actions (deletes) via the Things CLI, but SKILL.md documents conservative safeguards (UUID usage, read-back verification, retries) and asks for clarification on ambiguous deletions.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install things-plus - After installation, invoke the skill by name or use
/things-plus - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.1
**Expanded personal capture logic and streamlined environment checks.**
- Now triggers for natural planning phrases (e.g., “I should…”, “remind me to…”) and concrete future commitments, even when Things is not mentioned directly.
- Only blocks writes or prompts for setup when a write action actually fails; no more mandatory pre-flight at session start.
- Accepts and rewrites fuzzy action titles into clear next steps for better task management.
- Adds duplicate prevention logic: checks for recent or existing tasks before adding new ones.
- Clarifies token/auth handling—guides setup only if a specific operation actually fails for missing auth.
- Removes legacy/overly detailed setup flow in favor of more predictable, fail-fast behavior.
v1.2.0
things-plus 1.2.0
- New test_promt.md
- Added a new reference report file: `references/report.md`
- Fixed delete ops into one-by-one mode.
v1.1.3
fix safety issue
v1.1.2
No user-facing changes in this version.
- Internal metadata updated to declare required binary (`things`) and primary environment variable (`THINGS_AUTH_TOKEN`).
- No code or behavior changes; existing functionality remains unchanged.
v1.1.1
- Credential policy updated: now requires `THINGS_AUTH_TOKEN` to be configured locally in the execution environment (not pasted via chat).
- Revised setup guidance to emphasize local environment detection and direct, shell-specific export commands.
- Chat-based sharing of sensitive tokens is discouraged for improved security.
- More precise shell/context detection before providing setup commands.
- Task handling now pauses until local credential setup and verification are complete.
v1.1.0
**Version 1.1.0 of things-plus introduces improved, safer setup and capture logic:**
- Task capture is now limited to concrete, personal intentions; avoids auto-capturing hypothetical examples, quoted text, or indirect discussion.
- Pre-flight checks (for Things.app, CLI, and token) now run not just on setup intent, but also on the first real task-management request per session, before any task is handled.
- Token setup is more robust: the correct shell/context is detected, export/show commands are tailored, and token verification is performed in the actual agent context before proceeding.
- Write operations now require positive verification (not just exit status) via read-back and duplicate prevention before claiming success.
- Guidance reduced for non-actionable cases, and setup instructions avoid overwhelming the user with irrelevant shell commands.
v1.0.2
Summary: Task capture is now always-on — anything sounding like a task or plan is immediately added to Things, no extra confirmation needed.
- Automatically captures any to-do, plan, or intention mentioned by the user into Things without requiring confirmation.
- Earlier manual triggers (like "add to Things") are no longer needed for task entry.
- Stronger focus on proactive capture, even for casual or passing mentions of tasks.
- Maintains all previous setup and safety checks for Things.app, CLI presence, and token before any operations.
- All other task management, review, and field handling policies remain unchanged.
v1.0.1
- Adds explicit metadata declaring THINGS_AUTH_TOKEN and things CLI as required dependencies.
- Now marks THINGS_AUTH_TOKEN as the primary environment variable for operations.
- No functional changes to skill behavior; adds OpenClaw compatibility metadata only.
v1.0.0
things-plus 1.0.0 – Initial release
- Cron is intentionally not used for personal reminders; Things native scheduling is preferred except for background automation.
- Integrates with Things 3 on macOS via the `things` CLI for full to-do management: add, update, delete, search, and organize tasks, projects, areas, and tags.
- Implements robust setup checks: verifies Things.app and CLI exist, installs CLI when requested, and requires `THINGS_AUTH_TOKEN` for any operations.
- Guides first-time setup by confirming environment, helping users set up authentication, and refusing task operations until setup is confirmed.
- Reads and writes all standard Things views (Inbox, Today, Upcoming, etc.) and supports both list and object retrieval.
- Applies best practices for reminders, deadlines, tags, checklists, and repeats, including rewriting vague to-dos into actionable steps.
- Prioritizes user safety by requiring UUID targeting for modifications and dry-runs for risky actions.
Metadata
Frequently Asked Questions
What is Things plus?
Personal task manager powered by Things 3. Trigger when the user asks to add, capture, review, organize, reprioritize, search, or manage tasks in Things. Als... It is an AI Agent Skill for Claude Code / OpenClaw, with 204 downloads so far.
How do I install Things plus?
Run "/install things-plus" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Things plus free?
Yes, Things plus is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Things plus support?
Things plus is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Things plus?
It is built and maintained by Sars666 (@sars666); the current version is v1.2.1.
More Skills