Deixe um agente rodar sua lista de tarefas

MCP ou a CLI?

Prefira as ferramentas MCP quando seu agente já tiver uma conexão MCP com o TaskForge. Elas são tipadas, retornam erros estruturados que o agente pode usar para se autocorrigir, e não precisam de nada no seu PATH. Recorra à CLI em contextos de shell sem conexão MCP: scripts, cron, CI, ou um agente de código trabalhando em uma cópia local de um repositório. As duas rodam o mesmo motor com semântica idêntica, então escolha a que já está conectada no seu ambiente. Editar os arquivos do cofre manualmente é 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 na frente do 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 por meio 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 direto para o binário:

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

Somente desktop, já que é onde os clientes MCP vivem. 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, cobrindo todo o ciclo de vida de uma tarefa: criar, ler, atualizar, concluir, arquivar e excluir, cada uma com uma variante em lote; mover, reatribuir o item pai e converter entre uma linha inline e um arquivo de tarefa; uma checagem de lint antes de você escrever uma linha; uma chamada doctor para a saúde do cofre; e recursos de schema e Espaços, para que o agente aprenda seu formato antes de agir. As seis abaixo são as que você vai usar com mais frequência. Cada chamada relê o cofre direto do disco, então o agente sempre age sobre os arquivos atuais.

Cada ferramenta agora carrega anotações, então um cliente sabe de relance quais chamadas só leem, quais gravam e qual exclui. O restante do conjunto inclui 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 somente leitura para que o agente aprenda as regras do seu cofre antes de agir:

Se ele não encontrar o seu cofre

O servidor sempre inicia, mesmo antes de saber onde está o seu cofre, então o Claude Desktop nunca mostra um "falha ao iniciar o servidor" sem explicação. Quando uma chamada de ferramenta não consegue resolver um cofre, ela retorna um erro claro que o agente pode repassar: defina a variável de ambiente TASKFORGE_VAULT com o caminho do seu cofre, ou reinstale o pacote e informe o diretório do cofre quando solicitado.

Somente local

O servidor MCP do TaskForge roda localmente e lê e grava os arquivos Markdown do seu cofre. Instalar pelo npx baixa o pacote do npm. Seu cliente de IA pode enviar entradas e resultados das ferramentas ao provedor dele; as configurações de privacidade dele continuam valendo. A sincronização do seu cofre, a que você já usa, leva as edições entre os dispositivos.

Prefere um terminal?

Se você quer automatizar suas tarefas com scripts ou rodar comandos avulsos em vez de deixar um agente conduzir, a CLI do taskforge cobre o mesmo cofre com as mesmas regras.

Perguntas frequentes