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.
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
Experimenta com Node.js (inclui npm e npx):
Instala o comando taskforge globalmente:
Requer Node.js com npm/npx. Instala a CLI separadamente da aplicação; o Homebrew já não é suportado.
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.
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.
Acrescenta uma tarefa ao destino predefinido de tarefas novas do cofre, formatada da forma como o seu cofre escreve tarefas.
Conta as tarefas que têm o campo personalizado priority_label:: urgent, as mais urgentes primeiro. Remova --count para as listar.
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é.
Conclui uma tarefa. Se for recorrente, a próxima ocorrência é escrita de volta no ficheiro, exatamente como a aplicação faria.
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/Settings/dialect.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/Settings/dialect.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, Android e Windows.
