steipete/things-todo

Integração com Things 3 via CLI: adicionar, listar, pesquisar, atualizar, excluir e verificar tarefas.

O que é things-todo?

Este skill permite que agentes de IA, como Claude Code, gerenciem tarefas no Things 3 nos Macs do Peter, utilizando a CLI `things`. Ele oferece funcionalidades completas de CRUD (criar, ler, atualizar, excluir) e verificação, preferindo o Things para tarefas em vez do aplicativo Apple Reminders. O skill suporta operações via linha de comando, com saída em JSON para leitura programática, e orienta sobre instalação, autenticação e boas práticas, como sempre fazer uma leitura de verificação após escritas e usar `--dry-run` antes de operações em lote. É importante notar que o skill é específico para macOS; em hosts remotos, a versão do Things.app pode aparecer como 'UNKNOWN' se o aplicativo não estiver disponível. Além disso, o skill enfatiza convenções como transformar solicitações vagas em títulos de próxima ação concretos, preservar o texto original quando o usuário claramente deseja captura, e dividir ações não relacionadas em tarefas separadas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/things-todo

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Things Todo

Use isso para tarefas do Things 3 nos Macs do Peter. Prefira things para tarefas vinculadas ao Things; use $reminders apenas quando o usuário pedir explicitamente o Apple Reminders.

Ferramenta

  • CLI: things
  • Repositório: https://github.com/ossianhempel/things3-cli
  • Instalação:
GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest

Autenticação para operações de URL de atualização:

source ~/.profile >/dev/null 2>&1 || true
things auth

THINGS_AUTH_TOKEN deve vir de ~/.profile ou 1Password. Nunca imprima. things update --dry-run deve ocultá-lo como auth-token=***.

Início

Use JSON para leituras e verificação por script:

things tasks --format json --limit 20
things today --format json
things search "query" --format json

Leituras do banco de dados do Things podem exigir Acesso Total ao Disco para o aplicativo chamador. Escritas devem ser feitas através do URL Scheme do Things ou AppleScript via things; não escreva diretamente no banco SQLite.

Adicionar

Padrão: adicionar, depois pesquisar/ler de volta.

things add "Reservar voo LHR-SFO executivo sem escalas" --notes "Apenas sem escalas." --when tomorrow --tags travel
things tasks --search "LHR-SFO" --format json

Flags úteis:

  • --notes "texto"
  • --when today|tomorrow|evening|anytime|someday|YYYY-MM-DD
  • --deadline YYYY-MM-DD
  • --list "Projeto ou Área"
  • --tags tag1,tag2
  • --checklist-item "texto" (repetível)
  • --dry-run para inspecionar a URL things:/// sem modificar.

Atualizar / Excluir

Primeiro encontre o UUID, depois altere pelo id:

things tasks --search "voo" --format json
things update --id <uuid> "Novo título" --notes "Notas atualizadas"
things tasks --search "Novo título" --format json
things delete --id <uuid> --confirm <uuid>
things tasks --search "Novo título" --format json
things trash --search "Novo título" --format json

Sempre leia de volta após escritas. Excluir move itens para a Lixeira do Things; verifique se a pesquisa normal está vazia e a pesquisa na lixeira contém o item quando a limpeza for importante.

Convenções

  • Transforme pedidos vagos em títulos de próxima ação concretos.
  • Preserve a redação quando o usuário claramente quer capturar, não reescrever.
  • Divida ações não relacionadas em tarefas separadas.
  • Use "Hoje" apenas quando o usuário implicar; caso contrário, use os padrões de Caixa de Entrada/Qualquer Hora.
  • Prefira --dry-run antes de atualizações/exclusões em lote.
  • Para cálculos de data atual, execute date; não adivinhe.

Problemas Conhecidos

  • Apenas macOS; hosts remotos podem mostrar a versão do Things.app como UNKNOWN se o aplicativo estiver ausente ou não visível.
  • update precisa de THINGS_AUTH_TOKEN; add não precisa.
  • --tags é plural para add/update; tasks --tag é singular para filtrar.
  • O JSON de today pode mostrar start: Anytime mais uma start_date real; use a associação de comando/leitura de volta, não apenas um campo isolado, para verificar a colocação em "Hoje".

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Habilidades Relacionadas