Seu vault, direto do terminal

taskforge é uma pequena ferramenta de linha de comando que lê e grava as tarefas no seu vault do Obsidian. Ele usa o mesmo analisador que o app, então tarefas recorrentes avançam, as tarefas arquivadas vão para o lugar certo e suas linhas de tarefa continuam no seu formato. Entregue a um script de shell ou a um agente e ele edita arquivos markdown reais, nada hospedado.

Em breve no TaskForge 3.0

A CLI do TaskForge e o servidor MCP chegam com o lançamento do TaskForge 3.0. Tudo nesta página descreve como eles vão funcionar quando forem lançados. Já o app do TaskForge você pode baixar hoje mesmo.

A CLI ou o servidor MCP?

Use a 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. Se o seu agente já tem uma conexão MCP com o TaskForge, prefira as ferramentas MCP; elas são tipadas, retornam erros estruturados que o agente pode usar para se autocorrigir, e não precisam de nada no seu PATH. 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 vault manualmente é o último recurso.

Instalação

macOS e Linux, via Homebrew:

Disponível no lançamento

brew install azhard/tap/taskforge

Prefere o npm? O mesmo binário também é distribuído como pacote:

Disponível no lançamento

npm install -g taskforge

Uma cópia empacotada com o app, que se instala sozinha quando você abre um vault, está a caminho. Até lá, o tap acima é o caminho de entrada.

Início rápido

Aponte o taskforge para um vault com --vault, ou defina TASKFORGE_VAULT uma vez. Todo comando de leitura aceita --json para uma saída legível por máquina que um agente consegue interpretar.

taskforge schema

Imprime o dialeto de tarefas do vault: símbolos de status, formato de data, campos personalizados, para onde vão as tarefas novas. É a primeira coisa que um agente lê.

taskforge add "call the plumber" --due 2026-07-10 --priority high

Adiciona uma tarefa ao destino padrão de novas tarefas do vault, formatada do jeito que o seu vault escreve tarefas.

taskforge query 'prop:priority_label=urgent' --sort priority --count

Conta as tarefas que carregam o campo personalizado priority_label:: urgent, das mais urgentes primeiro. Remova --count para listá-las.

taskforge query 'desc:"invoice" text:acme' --json

Encontra tarefas cuja descrição menciona uma fatura e cujo título menciona acme, em JSON. Acentos e maiúsculas/minúsculas são ignorados, então cafe corresponde a café.

taskforge done <task-id>

Conclui uma tarefa. Se ela for recorrente, a próxima ocorrência é gravada de volta no arquivo, exatamente como o app faria.

taskforge show <task-id> --json

Lê uma tarefa com seu hash de conteúdo, para que uma edição seguinte possa passar --if-hash e recusar gravar sobre uma cópia desatualizada.

Gramática de consulta

O argumento de consulta é um conjunto de tokens separados por espaço, todos precisam corresponder. Os mais comuns:

text:word	O título contém a palavra (sem diferenciar acentos ou maiúsculas/minúsculas).	text:groceries
desc:"phrase"	A descrição da tarefa contém a frase.	desc:"send invoice"
tag:name	A tarefa carrega a tag #name.	tag:work
prop:key=value	O campo personalizado key é igual a value.	prop:area=home
prop:key	O campo personalizado key existe, com qualquer valor.	prop:estimate
--sort due\|priority\|created	Ordena os resultados. O padrão é data de vencimento, das mais próximas primeiro.	--sort priority
--count	Retorna o número de correspondências em vez das tarefas.	--count

As chaves de campos personalizados podem incluir letras, números e sublinhados, então priority_label e area_2 funcionam.

Um requisito: o contrato do vault

O taskforge lê um pequeno arquivo de contrato, taskforge/schema.json, que o TaskForge grava no seu vault. Ele descreve o formato exato das suas tarefas, para que a CLI edite as tarefas do seu jeito, em vez de adivinhar. Abra o vault no TaskForge 3.0 ou mais recente pelo menos uma vez, vá em Configurações, IA e agentes, e deixe "Gerar arquivos de agentes" ativado. Isso grava o contrato.

Se o taskforge não conseguir encontrar um vault, ele mostra as três formas de apontá-lo para um:

Passe --vault /path/to/vault no comando.
Defina a variável de ambiente TASKFORGE_VAULT.
Abra o vault uma vez no TaskForge 3.0+ para que taskforge/schema.json exista, depois execute a partir de dentro da pasta do vault.

Somente local

O taskforge roda na sua máquina e só toca nos arquivos markdown do vault que você apontar para ele. Sem conta, sem chave de API, sem chamadas de rede. O que já sincroniza o seu vault, iCloud, Dropbox ou Obsidian Sync, leva as edições para os seus outros dispositivos.

Quer que um agente controle isso?

A CLI é para terminais e scripts. Se você quer que o Claude Desktop ou outro cliente MCP adicione e conclua tarefas por meio de uma interface de ferramentas, configure o servidor MCP em vez disso. Mesmo vault, mesmas regras. De qualquer forma é o mesmo binário taskforge, então taskforge mcp --stdio basta para transformá-lo em um servidor MCP.

Configurar o servidor MCP →

A CLI edita as tarefas. O app as mantém vivas.

O taskforge grava no seu vault a partir de qualquer terminal; o TaskForge transforma esses mesmos arquivos em listas, widgets e lembretes no seu celular e computador. Gratuito para baixar no iPhone, iPad, Mac e Android.

Baixar Grátis - iOS e Mac

Baixar Grátis - Android