O seu cofre, a partir do terminal

O taskforge é uma pequena ferramenta de linha de comandos que lê e escreve as tarefas no seu cofre Obsidian. Usa o mesmo analisador que a aplicação, por isso as tarefas recorrentes avançam, os arquivos ficam no lugar certo e as suas linhas de tarefas mantêm o seu formato. Entregue-o a um script de shell ou a um agente e ele edita ficheiros markdown reais, nada alojado.

Brevemente no TaskForge 3.0

A CLI do TaskForge e o servidor MCP chegam com o lançamento do TaskForge 3.0. Tudo o que está descrito nesta página explica como vão funcionar assim que estiverem disponíveis. A aplicação TaskForge já pode ser descarregada hoje.

A CLI ou o servidor MCP?

Use a CLI a partir de contextos de shell sem ligação MCP: scripts, cron, CI, ou um agente de código que trabalha numa cópia local de um repositório. Se o seu agente já tiver uma ligação MCP ao TaskForge, prefira as ferramentas MCP; são tipadas, devolvem erros estruturados que o agente pode usar para se autocorrigir, e não precisam de nada no seu PATH. Ambos movem o mesmo motor com semântica idêntica, por isso escolha o que já está ligado no seu ambiente. Editar os ficheiros do cofre à mão é o último recurso.

Instalação

macOS e Linux, através do Homebrew:

Disponível no lançamento

brew install azhard/tap/taskforge

Prefere npm? O mesmo binário está disponível como pacote:

Disponível no lançamento

npm install -g taskforge

Está a chegar uma cópia integrada na aplicação que se instala sozinha quando abre um cofre. Até lá, o tap acima é a forma de entrada.

Início rápido

Aponte o taskforge para um cofre com --vault, ou defina TASKFORGE_VAULT uma única vez. Todos os comandos de leitura aceitam --json para uma saída legível por máquina que um agente consegue analisar.

taskforge schema

Imprime o dialeto de tarefas do cofre: símbolos de estado, formato de data, campos personalizados, para onde vão as tarefas novas. É isto que um agente lê primeiro.

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

Acrescenta uma tarefa ao destino predefinido de tarefas novas do cofre, formatada da forma como o seu cofre escreve tarefas.

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

Conta as tarefas que têm o campo personalizado priority_label:: urgent, as mais urgentes primeiro. Remova --count para as listar.

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

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

taskforge done <task-id>

Conclui uma tarefa. Se for recorrente, a próxima ocorrência é escrita de volta no ficheiro, exatamente como a aplicação faria.

taskforge show <task-id> --json

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

Gramática de consulta

O argumento de consulta é um conjunto de tokens separados por espaços, todos os quais têm de corresponder. Os mais comuns:

text:word	O título contém a palavra (insensível a acentos e a maiúsculas/minúsculas).	text:groceries
desc:"phrase"	A descrição da tarefa contém a frase.	desc:"send invoice"
tag:name	A tarefa tem a etiqueta #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. A predefinição é a data limite, mais próxima primeiro.	--sort priority
--count	Devolve o número de correspondências em vez das tarefas.	--count

As chaves de campos personalizados podem incluir letras, dígitos e underscores, por isso priority_label e area_2 funcionam ambos.

Um requisito: o contrato do cofre

O taskforge lê um pequeno ficheiro de contrato, taskforge/schema.json, que o TaskForge escreve no seu cofre. Descreve o formato exato das suas tarefas, para que a CLI edite tarefas à sua maneira em vez de adivinhar. Abra o cofre no TaskForge 3.0 ou posterior pelo menos uma vez, vá a Definições, IA e Agentes, e deixe "Gerar ficheiros para agentes" ativado. Isso escreve o contrato.

Se o taskforge não conseguir encontrar um cofre, indica as três formas de o apontar para um:

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

Apenas local

O taskforge é executado na sua máquina e só toca nos ficheiros markdown do cofre para o qual o aponta. Sem conta, sem chave de API, sem chamadas de rede. O que quer que já sincronize o seu cofre, iCloud, Dropbox ou Obsidian Sync, leva as edições para os seus outros dispositivos.

Quer que um agente o conduza?

A CLI é para terminais e scripts. Se quiser que o Claude Desktop ou outro cliente MCP adicione e conclua tarefas através de uma interface de ferramentas, configure antes o servidor MCP. Mesmo cofre, mesmas regras. Em qualquer dos casos é o mesmo binário taskforge, pelo que taskforge mcp --stdio basta para o transformar num servidor MCP.

Configurar o servidor MCP →

A CLI edita as tarefas. A aplicação mantém-nas vivas.

O taskforge escreve no seu cofre a partir de qualquer terminal; o TaskForge transforma esses mesmos ficheiros em listas, widgets e lembretes no seu telemóvel e computador. Gratuito para descarregar no iPhone, iPad, Mac e Android.

Grátis - iOS e Mac

Grátis - Android