Liste os itens abertos antes de adicionar outro
Ler primeiro evita TODOs duplicados quando vários agentes trabalham no mesmo escopo do projeto.
todo({ action: "list" })Ferramenta MCP pública
todo
Finalidade
Crie, atualize, conclua, liste ou exclua explicitamente em massa os TODOs do projeto, mantendo o estado da tarefa junto ao contexto autorizado do projeto.
Quando usar
- O usuário precisa de estado de tarefa duradouro, datas de vencimento, prioridade, conclusão ou uma lista de handoff.
- Um workspace de projeto precisa de uma alteração de TODO governada com sua capacidade de montagem assinada.
- O chamador precisa listar itens abertos, em andamento, concluídos ou todos os itens autorizados.
Quando NÃO usar
- Não use TODOs para fatos ou decisões duradouras gerais; use remember.
- Não armazene transações financeiras como conteúdo de TODO; use ledger.
- Não chame delete_all sem uma solicitação explícita do usuário e confirm_delete_all=true.
- A API REST aceita um conjunto de campos mais amplo que a ferramenta MCP pública; consulte /docs/api/memory para os filtros de scope, bucket, team e provenance.
Escopo necessário
- List usa memory:read; create, update, complete e delete_all usam memory:write na superfície pública de chat.
- As alterações do Project Workspace também exigem um mount_capability válido e project_id.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
action | create | update | complete | list | delete_all · obrigatório | Operação do dispatcher. |
todo_id | string | ID exato do item para atualização ou conclusão. |
content / title | string | Texto da tarefa; quando ambos forem fornecidos, eles precisam coincidir. |
project_id | string | Identificador do workspace de projeto autorizado. |
priority / due_at / status / note | string | Prioridade da tarefa, timestamp de vencimento, transição de status e nota de handoff. |
item_status / due_before / search / query | string | Filtros de lista; search e query são exclusivos de list e precisam concordar quando ambos forem fornecidos. |
limit / cursor / owner_timezone | integer / string · padrão: 20 / empty / configured timezone | Controles de paginação e interpretação de datas. |
client_mutation_id / expected_version | string / integer | Chave de idempotência para create/update e versão de concorrência otimista para update. |
confirm_delete_all | boolean · padrão: false | true é obrigatório para uma exclusão em massa recuperável e explícita. |
Esquema de retorno
A saída estruturada identifica a ação e retorna o(s) item(ns) afetado(s), o cursor de paginação, o status da alteração e metadados seguros da tarefa. A exclusão em massa é sempre uma exclusão lógica recuperável.
Exemplos
todo({
action: "create",
content: "Review the MCP scope matrix",
client_mutation_id: "task-review-scope-001",
due_at: "2026-08-25T09:00:00Z"
})todo({ action: "list", item_status: "open", limit: 10 })Erros
- Falha de autorização: list não possui memory:read ou uma alteração não possui memory:write/capacidade de projeto.
- Falha de validação: create não possui client_mutation_id, update não possui um expected_version positivo ou os campos da ação entram em conflito.
- Rejeição de segurança: delete_all exige confirmação explícita e não está disponível para chamadores de widget/mount-capability.
- Erros de fuso horário, projeto ou concorrência otimista são retornados explicitamente; o dispatcher não ignora campos silenciosamente.
Ferramentas relacionadas
- remember — Salve a decisão ou o fato duradouro por trás de uma tarefa.
- recall_context — Restaure o contexto da tarefa e do projeto antes de continuar.
- forget — Remova um TODO revisado pelo ID exato quando necessário.