Tu bóveda, desde la terminal
taskforge es una app de tareas para la línea de comandos que trabaja con las tareas y notas de tu bóveda de Obsidian. Consulta y completa tareas, crea y edita notas, o pásale los mismos comandos a un script de shell o a un agente. Usa el analizador de la app y escribe archivos Markdown reales en tu computadora.
¿La CLI o el servidor MCP?
Usa la CLI en contextos de shell sin conexión MCP: scripts, cron, CI, o un agente de código que trabaja en una copia local de un repositorio. Si tu agente ya tiene una conexión MCP con TaskForge, prefiere las herramientas MCP; están tipadas, devuelven errores estructurados con los que el agente puede autocorregirse, y no necesitan nada en tu PATH. Ambas usan el mismo motor con semántica idéntica, así que elige la que ya tengas conectada en tu entorno. Editar los archivos de la bóveda a mano es el último recurso.
Instalar
Pruébalo con Node.js (incluye npm y npx):
Instala el comando taskforge de forma global:
Requiere Node.js con npm/npx. npm instala un binario nativo para macOS, Windows (x64) y Linux (x64 y arm64). La app de TaskForge todavía no tiene versión para Linux; ahí usas la CLI y el servidor MCP. La CLI se instala por separado de la app; Homebrew ya no se admite.
Inicio rápido
Apunta taskforge a una bóveda con --vault, o define TASKFORGE_VAULT una sola vez. Cada comando de lectura acepta --json para obtener una salida legible por máquina que un agente puede analizar.
Imprime el dialecto de tareas de la bóveda: símbolos de estado, formato de fecha, campos personalizados, a dónde van las tareas nuevas. Esto es lo primero que lee un agente.
Agrega una tarea al destino predeterminado de la bóveda para tareas nuevas, con el formato en que tu bóveda escribe las tareas.
Cuenta las tareas que llevan el campo personalizado priority_label:: urgent, las más urgentes primero. Quita --count para listarlas.
Encuentra tareas cuya descripción menciona una factura y cuyo título menciona acme, en formato JSON. Se ignoran acentos y mayúsculas, así que cafe coincide con café.
Completa una tarea. Si es recurrente, la siguiente repetición se vuelve a escribir en el archivo, tal como lo haría la app.
Lee una tarea junto con su hash de contenido, para que una edición posterior pueda pasar --if-hash y evitar escribir sobre una copia desactualizada.
Gramática de consultas
El argumento de consulta es un conjunto de tokens separados por espacios, todos los cuales deben coincidir. Los más comunes:
| text:word | El título contiene la palabra (sin distinción de acentos ni mayúsculas). | text:groceries |
| desc:"phrase" | La descripción de la tarea contiene la frase. | desc:"send invoice" |
| tag:name | La tarea lleva la etiqueta #name. | tag:work |
| prop:key=value | El campo personalizado key es igual a value. | prop:area=home |
| prop:key | El campo personalizado key existe, con cualquier valor. | prop:estimate |
| --sort due|priority|created | Ordena los resultados. Por defecto es por fecha de vencimiento, la más próxima primero. | --sort priority |
| --count | Devuelve el número de coincidencias en lugar de las tareas. | --count |
Las claves de campos personalizados pueden incluir letras, dígitos y guiones bajos, así que priority_label y area_2 funcionan igual.
Un solo requisito: el contrato de la bóveda
taskforge lee un pequeño archivo de contrato, TaskForge/Settings/dialect.json, que TaskForge escribe en tu bóveda. Describe tu formato exacto de tareas para que la CLI edite las tareas a tu manera en lugar de adivinar. Abre la bóveda en TaskForge 3.0 o posterior al menos una vez, ve a Configuración, IA y agentes, y deja activado “Generar archivos de agentes”. Eso escribe el contrato. TaskForge/Settings es la ubicación predeterminada; la carpeta base se puede renombrar en la app.
Si taskforge no encuentra una bóveda, te indica las tres formas de apuntarlo a una:
- Pasa --vault /path/to/vault en el comando.
- Define la variable de entorno TASKFORGE_VAULT.
- Abre la bóveda una vez en TaskForge 3.0+ para que exista TaskForge/Settings/dialect.json, luego ejecuta el comando desde dentro de la carpeta de la bóveda.
Solo local
taskforge se ejecuta en tu computadora y solo toca los archivos markdown de la bóveda que le indiques. Sin cuenta, sin clave de API, sin llamadas de red. Lo que ya sincroniza tu bóveda, iCloud, Dropbox u Obsidian Sync, lleva las ediciones a tus demás dispositivos.
¿Quieres que un agente lo maneje?
La CLI es para terminales y scripts. Si quieres que Claude Desktop u otro cliente MCP agregue y complete tareas a través de una interfaz de herramientas, configura en su lugar el servidor MCP. Misma bóveda, mismas reglas. Es el mismo binario taskforge en ambos casos, así que basta con taskforge mcp --stdio para convertirlo en un servidor MCP.
Configurar el servidor MCP →La CLI edita las tareas. La app las mantiene vivas.
taskforge escribe en tu bóveda desde cualquier terminal; TaskForge convierte esos mismos archivos en listas, widgets y recordatorios en tu celular y tu computadora. Gratis para descargar en iPhone, iPad, Mac, Android y Windows.
