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

Gerencie suas tarefas sem sair do Cursor

O Cursor abre uma pasta e edita os arquivos dentro dela. Abra seu cofre do Obsidian e ele consegue adicionar, reagendar e concluir suas tarefas, que são linhas de markdown simples. Duas configurações levam você até lá: registre o servidor MCP do taskforge para ferramentas tipadas, ou insira uma regra de uma linha apontando para o arquivo de contrato do seu cofre, para que o Cursor escreva tarefas no seu formato desde a primeira tecla.

Duas formas de conectar

O arquivo de regras é o caminho mais rápido e não precisa de nada instalado. O servidor MCP adiciona ferramentas tipadas, caso você queira que o agente chame adicionar e concluir em vez de editar linhas à mão. Escolha uma, ou use as duas.

  1. Gere o contrato do cofre

    Abra seu cofre no TaskForge 3.0 ou mais recente, depois Configurações, IA e agentes, e mantenha "Gerar arquivos de agentes" ativado. O TaskForge grava uma pasta TaskForge/Settings/ descrevendo seu formato de tarefas, da qual as duas configurações abaixo dependem.

  2. Abra o cofre como pasta no Cursor

    Arquivo, Abrir Pasta, e escolha seu cofre. O Cursor agora enxerga cada nota, incluindo o contrato TaskForge/Settings/, no seu espaço de trabalho.

  3. Aponte uma regra para o contrato

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

    # .cursor/rules/taskforge.md
    When adding or editing tasks, first read TaskForge/Settings/agents.md
    in this cofre and follow its exact syntax and date format.
    Um arquivo, uma linha de intenção. Agora o Cursor reconhece um campo renomeado ou 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 o baixa na primeira execução, e o Cursor ganha 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"
          }
        }
      }
    }
    Salve isso como .cursor/mcp.json no projeto, ou adicione nas configurações MCP do Cursor.

Como o Cursor acerta o seu formato

Qualquer configuração que você escolher, a pasta TaskForge/Settings/ é a fonte da verdade. O arquivo de regras manda o Cursor ler agents.md; o servidor MCP expõe os mesmos dados como recursos. De qualquer forma, o Cursor escreve uma linha que suas outras ferramentas conseguem ler, no seu dialeto, de primeira.

TaskForge/Settings/agents.md A sintaxe de tarefas em português simples. Este é o arquivo para o qual sua regra .cursor aponta.
TaskForge/Settings/dialect.json A versão legível por máquina, exposta ao servidor MCP como taskforge://dialect.
TaskForge/Settings/spaces.json Seus Espaços salvos e para onde vão as tarefas novas, para que "adicione isso no meu Espaço de Trabalho" caia no lugar certo.

Prompts que funcionam

Peça ao Cursor no painel de chat com o cofre aberto. Ele lê o contrato, edita o markdown, e a mudança vira um diff que você pode revisar antes de aceitar.

Você pergunta ao Cursor

“Adicione uma tarefa para o pacote de revisão do cliente, vencendo na quinta, prioridade alta.”

O que chega ao arquivo

- [ ] pacote de revisão do cliente ⏫ 📅 2026-07-09

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

Você pergunta ao Cursor

“Leia meeting-notes.md e adicione cada pendência a tasks/this-week.md, cada uma vencendo na sexta.”

O que chega ao arquivo

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

- [ ] reservar o sinal do espaço 📅 2026-07-10

As linhas chegam ao seu cofre. O TaskForge as mostra na próxima vez que lê o cofre, e seu celular acompanha na próxima sincronização.

Nada sai da sua máquina

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

Perguntas que as pessoas fazem

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

O arquivo de regras é suficiente para a maioria das pessoas. Ele aponta o Cursor para TaskForge/Settings/agents.md, para que ele escreva tarefas no seu formato editando arquivos diretamente. Adicione o servidor MCP só se você quiser que o Cursor chame ferramentas tipadas como add_task e complete_task.

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

O Cursor ainda não descobre guias dentro do cofre automaticamente, então precisa de uma linha dizendo onde está TaskForge/Settings/agents.md. É um copiar e colar que você faz uma vez por cofre. Depois disso, o Cursor lê o contrato sozinho.

As tarefas vão aparecer no app TaskForge?

Sim. O Cursor edita os mesmos arquivos markdown que o TaskForge lê. O app pega a mudança naquela máquina na hora, e ela chega ao seu celular assim que a sincronização do seu cofre rodar.

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 ele preferir chamar. Os dois leem o mesmo contrato, então nunca discordam sobre seu dialeto.

Isso funciona com tarefas no estilo TaskNotes?

Sim. Se o seu cofre usa o TaskNotes, o contrato descreve esses campos e pastas em YAML, então o Cursor escreve uma tarefa válida do TaskNotes, não uma linha de checkbox comum.

Configurações relacionadas

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

Mantenha as tarefas no editor onde você já vive.

Markdown simples no seu próprio cofre, editado pelo Cursor. O TaskForge é grátis para baixar no iPhone, iPad, Mac, Android e Windows.