Saltar al contenido principal
TaskForge 3.0: tu IA lee tus tareas.

Claude Code ya puede leer y escribir tus tareas

Claude Code vive en la terminal y edita archivos, así que ya puede abrir tu bóveda de Obsidian y ajustarse a las líneas de markdown que encuentre. TaskForge añade un archivo TaskForge/Settings/agents.md a la bóveda que detalla tu formato exacto, así que apuntar Claude Code a la bóveda acierta desde la primera línea en lugar de intentar adivinar tu sintaxis. No hace falta ningún complemento, ninguna API ni ningún servidor MCP para lo básico.

Empieza una sesión en tu bóveda

Claude Code trabaja desde un directorio de trabajo. Convierte ese directorio en tu bóveda, y todo lo que necesita ya está en el disco.

  1. Genera el contrato una vez

    Abre tu bóveda en TaskForge 3.0 o posterior, luego Ajustes, IA y agentes, y deja activado «Generar archivos de agentes». Eso escribe TaskForge/Settings/agents.md y TaskForge/Settings/dialect.json en la bóveda. Si más adelante cambias un símbolo de estado o el formato de fecha, TaskForge los reescribe para que nunca se desactualicen.

  2. Inicia Claude Code en la bóveda

    Desde una terminal, entra en la carpeta de tu bóveda e inicia Claude Code ahí. La bóveda es ahora su directorio de trabajo, así que todos los archivos, incluido el contrato TaskForge/Settings/, están a su alcance.

    cd ~/Documents/MyVault
    claude
    Funciona con cualquier carpeta de bóveda, ya se sincronice con iCloud, Dropbox u Obsidian Sync.
  3. Dile que lea el contrato primero

    Una instrucción de una sola línea mantiene cada tarea que escribe en tu formato: pídele que lea TaskForge/Settings/agents.md antes de añadir o editar tareas. Pon la misma línea en un CLAUDE.md en la raíz de la bóveda y no tendrás que repetirla nunca.

    Lee TaskForge/Settings/agents.md, y luego añade cada pendiente
    de la nota diaria de hoy a tasks/this-week.md, con vencimiento el viernes.
    Claude Code abre la guía, ajusta tu dialecto y escribe las líneas.
  4. ¿Prefieres herramientas en vez de ediciones libres? Añade el servidor MCP

    Claude Code también es compatible con MCP. Registra el servidor taskforge y obtendrá las mismas herramientas tipadas de añadir, consultar y completar que usa la app de escritorio, con errores estructurados con los que puede autocorregirse.

    claude mcp add taskforge -- npx -y taskforge-md mcp --stdio
    Define TASKFORGE_VAULT si lo ejecutas desde fuera de la carpeta de la bóveda.

Lo que le dice el contrato

La carpeta TaskForge/Settings/ es la razón por la que Claude Code acierta tus tareas a la primera. Lee estos archivos como cualquier otra fuente del árbol de trabajo, así que un campo «due» renombrado o un estado personalizado «Waiting» es un dato que consulta, no algo que adivina.

TaskForge/Settings/agents.md La guía en lenguaje sencillo: tu dialecto de casillas, símbolos de estado, campos renombrados, formato de fecha y dónde van las tareas nuevas.
TaskForge/Settings/dialect.json Las mismas reglas en JSON estructurado, para cuando Claude Code prefiera analizar datos en vez de leer prosa.
TaskForge/Settings/spaces.json Tus espacios guardados y sus recetas de adición, para que «archiva esto en Recados» termine en la nota correcta.

Una sesión, de principio a fin

Este es el flujo de trabajo real, no una demo. Claude Code edita el archivo en el disco; TaskForge muestra el resultado en cuanto la app lee la bóveda, y tu móvil lo recibe en la siguiente sincronización.

Escribes

“Lee inbox.md y convierte cada pregunta sin responder en una tarea en tasks/this-week.md, con vencimiento el viernes.”

Lo que escribe Claude Code

- [ ] responder la pregunta de Priya sobre los formatos de exportación 📅 2026-07-10

- [ ] confirmar el número de asistentes del local con Sam 📅 2026-07-10

Lee la nota, escribe dos líneas con la sintaxis de tu bóveda y te dice qué ha añadido. Sin copiar y pegar, sin adivinar el formato.

Escribes

“¿Hay algo en tasks/ etiquetado #blocked con más de una semana de antigüedad? Súbelo a prioridad alta.”

Lo que escribe Claude Code

- [ ] esperando el visto bueno de legal ⏫ #blocked 📅 2026-07-02

Claude Code busca en tus archivos de tareas, encuentra las que llevan tiempo paradas y reescribe el marcador de prioridad directamente en el archivo. La edición es un diff normal que puedes revisar antes de hacer commit.

Archivos locales, ediciones revisables

Claude Code se ejecuta en tu dispositivo y solo toca los archivos de su directorio de trabajo. Como tus tareas son texto plano, cada cambio que hace es un diff que puedes leer, y el historial de versiones que ya tiene tu bóveda, git, iCloud u Obsidian Sync, hace que una mala edición se arregle con un solo revert. Sin cuenta de TaskForge, sin nube.

Preguntas frecuentes

¿Necesita Claude Code el servidor MCP para gestionar tareas?

No. Para lo básico, simplemente edita archivos. Abre tu bóveda como directorio de trabajo, dile que lea TaskForge/Settings/agents.md, y escribirá las tareas en tu formato. El servidor MCP es una opción si prefieres que use herramientas tipadas en vez de ediciones libres de archivos.

¿Cómo sabe Claude Code mi sintaxis de tareas?

Lee TaskForge/Settings/agents.md, el archivo de contrato que TaskForge genera en tu bóveda. Ese archivo describe tu dialecto exacto, los campos renombrados, los símbolos de estado y el formato de fecha, así que Claude Code los respeta en lugar de escribir una línea de tarea genérica que tus otras herramientas no puedan leer.

¿Detectará TaskForge las tareas que añada Claude Code con la app cerrada?

Sí. TaskForge vuelve a leer tu bóveda al abrirse y vigila los cambios mientras está en ejecución. Las tareas que Claude Code escriba en una sesión nocturna estarán ahí la próxima vez que abras la app.

¿Puedo evitar que toque los archivos equivocados?

Apúntalo a las notas de tareas que te importan, y revisa el diff antes de aceptar una edición. Como todo es texto plano en una carpeta que ya versionas, nada de lo que hace queda oculto ni es irreversible.

¿Funciona con una bóveda en iCloud u Obsidian Sync?

Sí. Claude Code edita la copia local de la bóveda; la sincronización que ya uses lleva los cambios a tu móvil y a tus otros dispositivos, igual que lleva las ediciones que haces en Obsidian.

Configuraciones relacionadas

Claude Code es una vía de entrada. La visión general de IA cubre el panorama completo, y las páginas de CLI y MCP profundizan en las superficies de terminal y de herramientas.

Tu terminal, tu bóveda, tus tareas.

Markdown plano que Claude Code puede leer y escribir. TaskForge se puede descargar gratis en iPhone, iPad, Mac, Android y Windows.