Deixe um agente gerir a sua lista de tarefas

MCP ou a CLI?

Prefira as ferramentas MCP quando o seu agente já tiver uma ligação MCP ao TaskForge. São tipadas, devolvem erros estruturados que o agente pode usar para se autocorrigir, e não precisam de nada no seu PATH. Recorra à CLI a partir de contextos de shell sem ligação MCP: scripts, cron, CI, ou um agente de código que trabalha numa cópia local de um repositório. Ambos movem o mesmo motor com semântica idêntica, por isso escolha o que já está ligado no seu ambiente. Editar os ficheiros do cofre à mão é o último recurso.

Instalação

{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

Compilou o taskforge a partir do código-fonte em vez de usar o npx? Aponte a configuração diretamente para o binário:

"command": "taskforge",
"args": ["mcp", "--stdio"]

Apenas para computador, porque é aí que vivem os clientes MCP. O taskforge é distribuído como um único binário nativo para macOS, Windows e Linux, e o servidor MCP é um dos seus subcomandos.

O conjunto completo de ferramentas

22 ferramentas ao todo, que cobrem todo o ciclo de vida de uma tarefa: criar, ler, atualizar, concluir, arquivar e eliminar, cada uma com uma variante em lote; mover, reatribuir o item superior e converter entre uma linha inline e um ficheiro TaskNotes; uma verificação lint antes de escrever uma linha; uma chamada doctor para o estado do cofre; e recursos de esquema e listas, para que o agente aprenda o seu formato antes de agir. As seis abaixo são as que vai usar com mais frequência. Cada chamada volta a ler o cofre a partir do disco, por isso o agente atua sempre sobre os ficheiros atuais.

Cada ferramenta tem anotações, para que um cliente saiba de relance quais as chamadas que só leem, quais escrevem e qual elimina. O resto do conjunto acrescenta bulk_add_tasks, bulk_update_tasks, bulk_complete_tasks, bulk_delete_tasks, get_tasks, archive_task, move_task, bulk_move_tasks, convert_task, bulk_convert_tasks, outdent_task, bulk_reparent_tasks, lint_task, doctor, list_task_lists e get_schema.

Três recursos

Além das ferramentas, o servidor expõe contexto apenas de leitura para que o agente aprenda as regras do seu cofre antes de atuar:

Se não conseguir encontrar o seu cofre

O servidor arranca sempre, mesmo antes de saber onde está o seu cofre, por isso o Claude Desktop nunca mostra um opaco "o servidor falhou ao iniciar". Quando uma chamada de ferramenta não consegue resolver um cofre, devolve um erro simples que o agente pode transmitir: defina a variável de ambiente TASKFORGE_VAULT para o caminho do seu cofre, ou reinstale o pacote e introduza a pasta do cofre quando for solicitado.

Apenas local

O taskforge mcp --stdio lê e escreve apenas os ficheiros markdown no cofre que configurar, e nada mais. Sem conta, sem nuvem. A sua sincronização já existente, iCloud, Dropbox ou Obsidian Sync, move as alterações entre dispositivos.

Prefere um terminal?

Se preferir escrever scripts para as suas tarefas ou executar comandos pontuais em vez de os conduzir a partir de um agente, a taskforge CLI cobre o mesmo cofre com as mesmas regras.

Perguntas frequentes