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 equipo.
¿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.
Instalación
Pruébalo con Node.js (incluye npm y npx):
Instala el comando taskforge globalmente:
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. Todos los comandos de lectura aceptan --json para obtener una salida legible por máquina que un agente pueda analizar.
Imprime el dialecto de tareas de la bóveda: símbolos de estado, formato de fecha, campos personalizados, dónde van las tareas nuevas. Esto es lo primero que lee un agente.
Añade una tarea al destino predeterminado de tareas nuevas de la bóveda, con el formato con el que tu bóveda escribe las tareas.
Cuenta las tareas que llevan el campo personalizado priority_label:: urgent, empezando por las más urgentes. Quita --count para listarlas.
Encuentra tareas cuya descripción mencione una factura y cuyo título mencione acme, en formato JSON. Se ignoran los acentos y las 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, exactamente 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 rechazar 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 habituales:
| text:word | El título contiene la palabra (sin distinguir 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, por fecha de vencimiento, de la más próxima a la más lejana. | --sort priority |
| --count | Devuelve el número de coincidencias en lugar de las tareas. | --count |
Las claves de campo personalizado pueden incluir letras, dígitos y guiones bajos, así que tanto priority_label como area_2 funcionan.
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 el formato exacto de tus tareas, para que la CLI las edite a tu manera en lugar de adivinar. Abre la bóveda en TaskForge 3.0 o posterior al menos una vez, ve a Ajustes, 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 señalarle 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, y luego ejecuta el comando desde dentro de la carpeta de la bóveda.
Solo local
taskforge se ejecuta en tu ordenador y solo toca los archivos markdown de la bóveda a la que lo apuntas. 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 lo maneje un agente?
La CLI es para terminales y scripts. Si quieres que Claude Desktop u otro cliente MCP añada y complete tareas a través de una interfaz de herramientas, lo que necesitas es 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.
Configura 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 móvil y tu ordenador. Gratis para descargar en iPhone, iPad, Mac, Android y Windows.
