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"
      }
    }
  }
}

No Windows, coloque cmd /c antes de npx. Clientes MCP de desktop como o Claude Desktop iniciam o servidor sem shell, e o npx é um script .cmd que o Windows só executa através de uma:

{
  "mcpServers": {
    "taskforge": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "C:\\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 e Windows, e o servidor MCP é um dos seus subcomandos. A versão para Linux chega em breve.

O conjunto completo de ferramentas

30 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 de tarefa; uma verificação lint antes de escrever uma linha; uma chamada doctor para o estado do cofre; e recursos de esquema e Espaços, 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_spaces e create_note, read_note, update_note, patch_note_block, patch_note_frontmatter, delete_note, move_note, normalize_references, get_dialect.

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 servidor MCP do TaskForge corre localmente e lê e escreve os ficheiros Markdown do seu cofre. A instalação através do npx descarrega o pacote do npm. O seu cliente de IA pode enviar entradas e resultados de ferramentas ao respetivo fornecedor; as definições de privacidade dele continuam a aplicar-se. A sincronização do seu cofre existente transporta as ediçõ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