things-mac

CLI do Things 3

Use things para ler seu banco de dados local do Things (caixa de entrada/hoje/pesquisa/projetos/áreas/tags) e para adicionar/atualizar tarefas via o esquema de URL do Things.

Configuração

• Instalar (recomendado, Apple Silicon): GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
• Se a leitura do BD falhar: conceda Acesso Total ao Disco ao aplicativo chamador (Terminal para execuções manuais; OpenClaw.app para execuções via gateway).
• Opcional: defina THINGSDB (ou passe --db) para apontar para sua pasta ThingsData-*.
• Opcional: defina THINGS_AUTH_TOKEN para evitar passar --auth-token nas operações de atualização.

Somente leitura (BD)

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

Escrita (esquema de URL)

• Pré-visualização segura recomendada: things --dry-run add "Título"
• Adicionar: things add "Título" --notes "..." --when today --deadline 2026-01-02
• Trazer Things para frente: things --foreground add "Título"

Exemplos: adicionar uma tarefa

• Básico: things add "Comprar leite"
• Com notas: things add "Comprar leite" --notes "2% + bananas"
• Em um projeto/área: things add "Reservar voos" --list "Viagem"
• Em um cabeçalho de projeto: things add "Carregar carregador" --list "Viagem" --heading "Antes"
• Com tags: things add "Ligar para dentista" --tags "saúde,telefone"
• Lista de verificação: things add "Preparar viagem" --checklist-item "Passaporte" --checklist-item "Bilhetes"
• Da STDIN (multi-linha => título + notas):
  • cat <<'EOF' | things add -
  • Linha do título
  • Linha da nota 1
  • Linha da nota 2
  • EOF

Exemplos: modificar uma tarefa (requer token de autenticação)

• Primeiro: obter o ID (coluna UUID): things search "leite" --limit 5
• Autenticação: defina THINGS_AUTH_TOKEN ou passe --auth-token <TOKEN>
• Título: things update --id <UUID> --auth-token <TOKEN> "Novo título"
• Substituir notas: things update --id <UUID> --auth-token <TOKEN> --notes "Novas notas"
• Acrescentar/antepor notas: things update --id <UUID> --auth-token <TOKEN> --append-notes "..." / --prepend-notes "..."
• Mover listas: things update --id <UUID> --auth-token <TOKEN> --list "Viagem" --heading "Antes"
• Substituir/adicionar tags: things update --id <UUID> --auth-token <TOKEN> --tags "a,b" / things update --id <UUID> --auth-token <TOKEN> --add-tags "a,b"
• Concluir/cancelar (soft-delete-ish): things update --id <UUID> --auth-token <TOKEN> --completed / --canceled
• Pré-visualização segura: things --dry-run update --id <UUID> --auth-token <TOKEN> --completed

Excluir uma tarefa?

• Não suportado pelo things3-cli atualmente (nenhum comando de escrita "excluir/mover para lixeira"; things trash é apenas listagem somente leitura).
• Opções: use a interface do Things para excluir/enviar para lixeira, ou marque como --completed / --canceled via things update.

Notas

• Apenas macOS.
• --dry-run imprime a URL e não abre o Things.