Pular para o conteúdo principal
TaskForge 3.0: a sua IA lê as suas tarefas.

Gira as suas tarefas sem sair do Cursor

O Cursor abre uma pasta e edita os ficheiros que lá estão. Abra o seu cofre Obsidian e ele pode adicionar, reagendar e concluir as suas tarefas, que são simples linhas de markdown. Duas configurações levam-no lá: registe o servidor MCP taskforge para ferramentas tipadas, ou coloque uma regra de uma linha a apontar para o ficheiro de contrato do seu cofre, para que o Cursor escreva tarefas no seu formato desde a primeira tecla.

Duas formas de o configurar

O ficheiro de regras é o caminho mais rápido e não precisa de nada instalado. O servidor MCP acrescenta ferramentas tipadas se quiser que o agente chame adicionar e concluir em vez de editar linhas à mão. Escolha uma, ou use ambas.

  1. Gere o contrato do cofre

    Abra o seu cofre no TaskForge 3.0 ou posterior, depois Definições, IA e Agentes, e deixe "Gerar ficheiros para agentes" ativado. O TaskForge escreve uma pasta TaskForge/Settings/ que descreve o seu formato de tarefas, da qual dependem as duas configurações abaixo.

  2. Abra o cofre como pasta no Cursor

    Ficheiro, Abrir Pasta, e escolha o seu cofre. O Cursor vê agora todas as notas, incluindo o contrato TaskForge/Settings/, no seu espaço de trabalho.

  3. Aponte uma regra para o contrato

    O Cursor ainda não descobre automaticamente guias dentro do cofre, por isso diga-lhe onde está o seu. Adicione uma regra de projeto que referencie o TaskForge/Settings/agents.md, e o Cursor lê-a antes de escrever qualquer tarefa.

    # .cursor/rules/taskforge.md
    Ao adicionar ou editar tarefas, leia primeiro o TaskForge/Settings/agents.md
    neste cofre e siga exatamente a sua sintaxe e formato de data.
    Um ficheiro, uma linha de intenção. O Cursor passa a corresponder a um campo com outro nome ou a uma pasta do TaskNotes em vez de adivinhar.
  4. Ou adicione o servidor MCP para ferramentas tipadas

    Prefere que o agente chame ferramentas? Adicione o taskforge à configuração MCP do Cursor. O npx obtém-no na primeira execução, e o Cursor recebe add_task, query_tasks, complete_task e o resto.

    {
      "mcpServers": {
        "taskforge": {
          "command": "npx",
          "args": ["-y", "taskforge-md", "mcp", "--stdio"],
          "env": {
            "TASKFORGE_VAULT": "/path/to/your/vault"
          }
        }
      }
    }
    Guarde isto como .cursor/mcp.json no projeto, ou adicione-o nas definições MCP do Cursor.

Como o Cursor acerta no seu formato

Seja qual for a configuração que escolher, a pasta TaskForge/Settings/ é a fonte de verdade. O ficheiro de regras envia o Cursor para ler o agents.md; o servidor MCP expõe os mesmos dados como recursos. De qualquer forma, o Cursor escreve uma linha que as suas outras ferramentas conseguem ler, no seu dialeto, à primeira tentativa.

TaskForge/Settings/agents.md A sua sintaxe de tarefas em inglês simples. É este o ficheiro para o qual aponta a sua regra .cursor.
TaskForge/Settings/dialect.json A versão legível por máquina, exposta ao servidor MCP como taskforge://dialect.
TaskForge/Settings/spaces.json Os seus Espaços guardados e para onde vão as tarefas novas, para que "adiciona isto ao meu Espaço de Trabalho" a arquive corretamente.

Prompts que funcionam

Peça ao Cursor no painel de conversa com o cofre aberto. Ele lê o contrato, edita o markdown, e a alteração é um diff que pode rever antes de o aceitar.

Pede ao Cursor

“Adiciona uma tarefa para o dossiê de revisão do cliente, com prazo na quinta-feira, prioridade alta.”

O que fica no ficheiro

- [ ] client review packet ⏫ 📅 2026-07-09

O Cursor lê primeiro o TaskForge/Settings/agents.md, por isso o marcador de prioridade e o formato de data correspondem a este cofre, e não a um palpite genérico.

Pede ao Cursor

“Lê o meeting-notes.md e adiciona cada ação a tasks/this-week.md, todas com prazo esta sexta-feira.”

O que fica no ficheiro

- [ ] enviar o contrato assinado para o jurídico 📅 2026-07-10

- [ ] book the venue deposit 📅 2026-07-10

As linhas ficam no seu cofre. O TaskForge mostra-as da próxima vez que lê o cofre, e o seu telemóvel segue-se na próxima sincronização.

Nada sai da sua máquina

O Cursor edita os ficheiros locais na pasta que abriu, e o servidor MCP taskforge, se o usar, também corre localmente. Sem conta TaskForge, sem nuvem. A sua sincronização já existente, iCloud, Dropbox ou Obsidian Sync, move as edições para os seus outros dispositivos.

Perguntas que nos fazem

Preciso do servidor MCP, ou o ficheiro de regras é suficiente?

O ficheiro de regras é suficiente para a maioria das pessoas. Aponta o Cursor para o TaskForge/Settings/agents.md, para que escreva tarefas no seu formato editando ficheiros diretamente. Adicione o servidor MCP apenas se quiser que o Cursor chame ferramentas tipadas como add_task e complete_task em vez disso.

Porque é que o Cursor precisa de uma regra e o Claude Code não?

O Cursor ainda não descobre automaticamente guias dentro do cofre, por isso precisa de uma linha a dizer-lhe onde está o TaskForge/Settings/agents.md. É uma cópia e cola que faz uma vez por cofre. Depois disso, o Cursor lê o contrato sozinho.

As tarefas aparecem na aplicação TaskForge?

Sim. O Cursor edita os mesmos ficheiros markdown que o TaskForge lê. A aplicação apanha a alteração nessa máquina de imediato, e chega ao seu telemóvel assim que a sincronização do cofre correr.

Posso usar a regra e o servidor MCP ao mesmo tempo?

Sim. A regra mantém as edições livres no seu formato, e o servidor MCP dá ao agente ferramentas tipadas para as ações que preferir chamar. Ambos leem o mesmo contrato, por isso nunca discordam sobre o seu dialeto.

Isto funciona com tarefas ao estilo TaskNotes?

Sim. Se o seu cofre usar o TaskNotes, o contrato descreve esses campos e pastas YAML, para que o Cursor escreva uma tarefa TaskNotes válida, e não uma simples linha de checkbox.

Configurações relacionadas

O Cursor é um editor entre muitos. A visão geral de IA cobre o panorama completo, e as páginas do MCP e da CLI aprofundam cada superfície.

Mantenha as tarefas no editor onde já vive.

Markdown simples no seu próprio cofre, editado pelo Cursor. O TaskForge é de transferência gratuita no iPhone, iPad, Mac, Android e Windows.