Seu cofre, direto do terminal
taskforge é um app de tarefas de linha de comando para as tarefas e notas do seu cofre do Obsidian. Consulte e conclua tarefas, crie e edite notas, ou passe os mesmos comandos para um script de shell ou um agente. Ele usa o analisador do app e grava arquivos Markdown reais no seu computador.
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 cofre manualmente é o último recurso.
Instalação
Experimente com Node.js (inclui npm e npx):
Instale o comando taskforge globalmente:
Requer Node.js com npm/npx. O npm instala um binário nativo para macOS, Windows (x64) e Linux (x64 e arm64). O app TaskForge ainda não tem versão para Linux; lá você usa a CLI e o servidor MCP. Instale a CLI separadamente do app; o Homebrew não é mais compatível.
Início rápido
Aponte o taskforge para um cofre 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.
Imprime o dialeto de tarefas do cofre: símbolos de status, formato de data, campos personalizados, para onde vão as tarefas novas. É a primeira coisa que um agente lê.
Adiciona uma tarefa ao destino padrão de novas tarefas do cofre, formatada do jeito que o seu cofre escreve tarefas.
Conta as tarefas que carregam o campo personalizado priority_label:: urgent, das mais urgentes primeiro. Remova --count para listá-las.
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é.
Conclui uma tarefa. Se ela for recorrente, a próxima ocorrência é gravada de volta no arquivo, exatamente como o app faria.
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 cofre
O taskforge lê um pequeno arquivo de contrato, TaskForge/Settings/dialect.json, que o TaskForge grava no seu cofre. Ele descreve o formato exato das suas tarefas, para que a CLI edite as tarefas do seu jeito, em vez de adivinhar. Abra o cofre 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 cofre, 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 cofre uma vez no TaskForge 3.0+ para que TaskForge/Settings/dialect.json exista, depois execute a partir de dentro da pasta do cofre.
Somente local
O taskforge roda na sua máquina e só toca nos arquivos markdown do cofre que você apontar para ele. Sem conta, sem chave de API, sem chamadas de rede. O que já sincroniza o seu cofre, 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 cofre, 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 cofre 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, Android e Windows.
