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

O Claude Code já lê e grava suas tarefas hoje

O Claude Code vive no terminal e edita arquivos, então ele já consegue abrir seu cofre do Obsidian e reconhecer as linhas de markdown que encontra. O TaskForge adiciona um arquivo TaskForge/Settings/agents.md ao cofre que detalha seu formato exato, então apontar o Claude Code para o cofre o faz acertar desde a primeira linha, em vez de tentar adivinhar sua sintaxe. Não há plugin, API nem servidor MCP necessário para o básico.

Comece uma sessão no seu cofre

O Claude Code trabalha a partir de um diretório de trabalho. Faça desse diretório o seu cofre, e tudo que ele precisa já está no disco.

  1. Gere o contrato uma vez

    Abra seu cofre no TaskForge 3.0 ou mais recente, depois Configurações, IA e agentes, e mantenha "Gerar arquivos de agentes" ativado. Isso grava TaskForge/Settings/agents.md e TaskForge/Settings/dialect.json no cofre. Se você mudar um símbolo de status ou o formato de data depois, o TaskForge os regrava, para que nunca fiquem defasados.

  2. Inicie o Claude Code no cofre

    Num terminal, entre na pasta do seu cofre e inicie o Claude Code ali. O cofre agora é o diretório de trabalho dele, então todo arquivo, incluindo o contrato TaskForge/Settings/, está ao alcance.

    cd ~/Documents/MyVault
    claude
    Qualquer pasta de cofre funciona, sincronizando por iCloud, Dropbox ou Obsidian Sync.
  3. Diga a ele para ler o contrato primeiro

    Uma instrução de uma linha mantém toda tarefa que ele escreve no seu formato: peça para ele ler TaskForge/Settings/agents.md antes de adicionar ou editar tarefas. Coloque a mesma linha num CLAUDE.md na raiz do cofre e você nunca mais precisa repeti-la.

    Read TaskForge/Settings/agents.md, then add every action item
    from today's daily note to tasks/this-week.md, due Friday.
    O Claude Code abre o guia, reconhece seu dialeto e escreve as linhas.
  4. Prefere ferramentas em vez de edições livres? Adicione o servidor MCP

    O Claude Code também fala MCP. Registre o servidor taskforge e ele ganha as mesmas ferramentas tipadas de adicionar, consultar e concluir que o app desktop usa, com erros estruturados para se autocorrigir.

    claude mcp add taskforge -- npx -y taskforge-md mcp --stdio
    Defina TASKFORGE_VAULT se você rodar de fora da pasta do cofre.

O que o contrato conta a ele

A pasta TaskForge/Settings/ é o motivo inteiro pelo qual o Claude Code acerta suas tarefas de primeira. Ele lê esses arquivos como qualquer outra fonte na árvore de trabalho, então um campo "due" renomeado ou um status personalizado "Waiting" é um fato que ele consulta, não um palpite que ele faz.

TaskForge/Settings/agents.md O guia em linguagem simples: seu dialeto de checkbox, símbolos de status, campos renomeados, formato de data e para onde vão as tarefas novas.
TaskForge/Settings/dialect.json As mesmas regras em JSON estruturado, para quando o Claude Code preferir interpretar em vez de ler prosa.
TaskForge/Settings/spaces.json Seus Espaços salvos e suas receitas de adição, para que "arquive isso em Errands" caia na nota certa.

Uma sessão, do início ao fim

Este é o fluxo de trabalho, não uma demonstração. O Claude Code edita o arquivo no disco; o TaskForge mostra o resultado no momento em que o app lê o cofre, e seu celular acompanha na próxima sincronização.

Você digita

“Leia o inbox.md e transforme cada pergunta sem resposta numa tarefa em tasks/this-week.md, cada uma vencendo na sexta.”

O que o Claude Code escreve

- [ ] responder a pergunta da Priya sobre formatos de exportação 📅 2026-07-10

- [ ] confirmar o número de participantes do local com o Sam 📅 2026-07-10

Ele lê a nota, escreve duas linhas na sintaxe do seu cofre e conta o que adicionou. Sem copiar e colar, sem adivinhar formato.

Você digita

“Alguma tarefa em tasks/ marcada com #blocked há mais de uma semana? Suba a prioridade.”

O que o Claude Code escreve

- [ ] aguardando aprovação do jurídico ⏫ #blocked 📅 2026-07-02

O Claude Code varre seus arquivos de tarefas, encontra as paradas e reescreve o marcador de prioridade no lugar. A edição é um diff simples que você pode revisar antes de fazer commit.

Arquivos locais, edições revisáveis

O Claude Code roda na sua máquina e só toca nos arquivos do seu diretório de trabalho. Como suas tarefas são texto simples, cada mudança que ele faz é um diff que você pode ler, e o histórico de versões já existente do seu cofre, git, iCloud ou Obsidian Sync, significa que uma edição ruim está a um revert de distância. Sem conta do TaskForge, sem nuvem.

Perguntas que as pessoas fazem

O Claude Code precisa do servidor MCP para gerenciar tarefas?

Não. Para o básico ele simplesmente edita arquivos. Abra seu cofre como diretório de trabalho, peça para ele ler TaskForge/Settings/agents.md, e ele escreve tarefas no seu formato. O servidor MCP é uma opção se você preferir que ele use ferramentas tipadas em vez de edições livres.

Como o Claude Code conhece minha sintaxe de tarefas?

Ele lê TaskForge/Settings/agents.md, o arquivo de contrato que o TaskForge gera no seu cofre. Esse arquivo descreve seu dialeto exato, campos renomeados, símbolos de status e formato de data, então o Claude Code os reconhece em vez de escrever uma linha genérica que suas outras ferramentas não conseguem ler.

O TaskForge percebe tarefas que o Claude Code adiciona com o app fechado?

Sim. O TaskForge relê seu cofre ao abrir e monitora as mudanças enquanto está em execução. Tarefas que o Claude Code escreve numa sessão noturna estarão lá quando você abrir o app da próxima vez.

Posso impedir que ele toque nos arquivos errados?

Aponte-o para as notas de tarefas que importam para você, e revise o diff antes de aceitar uma edição. Como tudo é texto simples numa pasta que você já versiona, nada do que ele faz fica oculto ou é irreversível.

Isso funciona com um cofre no iCloud ou no Obsidian Sync?

Sim. O Claude Code edita a cópia local do cofre; a sincronização que você já usa leva as mudanças para o seu celular e outras máquinas, do mesmo jeito que leva as edições que você faz no Obsidian.

Configurações relacionadas

O Claude Code é um caminho de entrada. A visão geral de IA cobre o quadro completo, e as páginas de CLI e MCP se aprofundam nas superfícies de terminal e de ferramentas.

Seu terminal, seu cofre, suas tarefas.

Markdown simples que o Claude Code lê e grava. O TaskForge é grátis para baixar no iPhone, iPad, Mac, Android e Windows.