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

O Claude Code já pode ler e escrever as suas tarefas hoje

O Claude Code vive no terminal e edita ficheiros, por isso já pode abrir o seu cofre Obsidian e corresponder às linhas de markdown que encontra. O TaskForge acrescenta um ficheiro TaskForge/Settings/agents.md ao cofre que descreve o seu formato exato, por isso apontar o Claude Code para o cofre acerta desde a primeira linha em vez de andar a adivinhar a sua sintaxe. Não é preciso plugin, API nem servidor MCP 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 o que precisa já está no disco.

  1. Gere o contrato uma vez

    Abra o seu cofre no TaskForge 3.0 ou posterior, depois Definições, IA e Agentes, e deixe "Gerar ficheiros para agentes" ativado. Isso escreve o TaskForge/Settings/agents.md e o TaskForge/Settings/dialect.json no cofre. Se mudar um símbolo de estado ou o formato de data mais tarde, o TaskForge reescreve-os para que nunca fiquem desatualizados.

  2. Inicie o Claude Code no cofre

    Num terminal, mude para a pasta do seu cofre e inicie o Claude Code aí. O cofre é agora o seu diretório de trabalho, por isso todos os ficheiros, incluindo o contrato TaskForge/Settings/, estão ao seu alcance.

    cd ~/Documents/MyVault
    claude
    Qualquer pasta de cofre funciona, quer sincronize através de iCloud, Dropbox ou Obsidian Sync.
  3. Diga-lhe para ler o contrato primeiro

    Uma instrução de uma linha mantém todas as tarefas que escreve no seu formato: peça-lhe para ler o TaskForge/Settings/agents.md antes de adicionar ou editar tarefas. Coloque a mesma linha num CLAUDE.md na raiz do cofre e nunca mais terá de a repetir.

    Leia o TaskForge/Settings/agents.md e depois adicione cada item de ação
    da nota diária de hoje a tasks/this-week.md, com prazo para sexta-feira.
    O Claude Code abre o guia, corresponde ao seu dialeto e escreve as linhas.
  4. Prefere ferramentas a edições livres? Adicione o servidor MCP

    O Claude Code também fala MCP. Registe o servidor taskforge e ele obtém as mesmas ferramentas tipadas de adicionar, consultar e concluir que a aplicação de computador usa, com erros estruturados que consegue usar para se autocorrigir.

    claude mcp add taskforge -- npx -y taskforge-md mcp --stdio
    Defina TASKFORGE_VAULT se o executar a partir de fora da pasta do cofre.

O que o contrato lhe diz

A pasta TaskForge/Settings/ é toda a razão pela qual o Claude Code acerta nas suas tarefas à primeira tentativa. Lê estes ficheiros como qualquer outra fonte na árvore de trabalho, por isso um campo "due" renomeado ou um estado personalizado "Waiting" é um facto que procura, não um palpite que faz.

TaskForge/Settings/agents.md O guia em linguagem simples: o seu dialeto de checkbox, símbolos de estado, campos com outro nome, 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 prefere analisar em vez de ler prosa.
TaskForge/Settings/spaces.json Os seus Espaços guardados e as respetivas receitas de adição, para que "arquiva isto em Recados" acabe na nota certa.

Uma sessão, do início ao fim

Isto é o fluxo de trabalho, não uma demonstração. O Claude Code edita o ficheiro no disco; o TaskForge mostra o resultado no momento em que a aplicação lê o cofre, e o seu telemóvel segue-se na próxima sincronização.

Escreve

“Lê o inbox.md e transforma cada pergunta sem resposta numa tarefa em tasks/this-week.md, cada uma com prazo na sexta-feira.”

O que o Claude Code escreve

- [ ] answer Priya's question about export formats 📅 2026-07-10

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

Lê a nota, escreve duas linhas na sintaxe do seu cofre, e diz-lhe o que adicionou. Sem copiar e colar, sem adivinhar o formato.

Escreve

“Há alguma coisa em tasks/ marcada com #blocked há mais de uma semana? Sobe a prioridade alta.”

O que o Claude Code escreve

- [ ] waiting on legal sign-off ⏫ #blocked 📅 2026-07-02

O Claude Code procura nos seus ficheiros de tarefas, encontra as desatualizadas e reescreve o marcador de prioridade no lugar. A edição é um diff simples que pode rever antes de a integrar.

Ficheiros locais, edições revisíveis

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

Perguntas que nos fazem

O Claude Code precisa do servidor MCP para gerir tarefas?

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

Como é que o Claude Code sabe a minha sintaxe de tarefas?

Lê o TaskForge/Settings/agents.md, o ficheiro de contrato que o TaskForge gera no seu cofre. Esse ficheiro descreve o seu dialeto exato, campos com outro nome, símbolos de estado e formato de data, por isso o Claude Code corresponde a eles em vez de escrever uma linha de tarefa genérica que as suas outras ferramentas não conseguem ler.

O TaskForge repara nas tarefas que o Claude Code adiciona com a aplicação fechada?

Sim. O TaskForge volta a ler o seu cofre quando abre e vigia-o enquanto está em execução. As tarefas que o Claude Code escreve numa sessão noturna estão lá quando abre a aplicação a seguir.

Posso impedi-lo de tocar nos ficheiros errados?

Aponte-o para as notas de tarefas que lhe interessam, e reveja o diff antes de aceitar uma edição. Como tudo é texto simples numa pasta que já versiona, nada do que faz fica escondido ou é irreversível.

Isto 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 já usa leva as alterações para o seu telemóvel e outras máquinas, da mesma forma que leva as edições que faz no Obsidian.

Configurações relacionadas

O Claude Code é uma forma de entrada. A visão geral de IA cobre o panorama completo, e as páginas da CLI e do MCP aprofundam as superfícies de terminal e de ferramentas.

O seu terminal, o seu cofre, as suas tarefas.

Markdown simples que o Claude Code consegue ler e escrever. O TaskForge é de transferência gratuita no iPhone, iPad, Mac, Android e Windows.