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

Claude Code puede leer y escribir tus tareas hoy

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 encuentra. TaskForge agrega un archivo TaskForge/Settings/agents.md a la bóveda que detalla tu formato exacto, así que apuntar Claude Code a la bóveda lo hace acertar desde la primera línea en lugar de adivinar tu sintaxis por patrones. No hace falta complemento, API ni servidor MCP para lo básico.

Inicia 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 sola vez

    Abre tu bóveda en TaskForge 3.0 o posterior, luego ve a Configuración, 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 queden desactualizados.

  2. Inicia Claude Code en la bóveda

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

    cd ~/Documents/MyVault
    claude
    Cualquier carpeta de bóveda funciona, ya sea que se sincronice por 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 agregar o editar tareas. Pon esa misma línea en un CLAUDE.md en la raíz de la bóveda y nunca tendrás que repetirla.

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

    Claude Code también puede hablar MCP. Registra el servidor taskforge y obtiene las mismas herramientas tipadas de agregar, 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 el contrato le dice

La carpeta TaskForge/Settings/ es la razón por la que Claude Code acierta tus tareas desde el primer intento. Lee estos archivos como cualquier otra fuente en el á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 a dónde van las tareas nuevas.
TaskForge/Settings/dialect.json Las mismas reglas como JSON estructurado, para cuando Claude Code prefiere analizar datos en lugar de leer texto.
TaskForge/Settings/spaces.json Tus espacios guardados y sus recetas para agregar tareas, para que “guarda esto en Mandados” termine en la nota correcta.

Una sesión, de principio a fin

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

Tú escribes

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

Lo que escribe Claude Code

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

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

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

Tú escribes

“¿Hay algo en tasks/ etiquetado #blocked que tenga más de una semana? Súbele la prioridad a alta.”

Lo que escribe Claude Code

- [ ] esperando la aprobación de legal ⏫ #blocked 📅 2026-07-02

Claude Code hace grep en tus archivos de tareas, encuentra las desactualizadas y reescribe el marcador de prioridad directamente en el archivo. La edición es un diff simple que puedes revisar antes de confirmarlo.

Archivos locales, ediciones revisables

Claude Code corre en tu computadora 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

¿Claude Code necesita el servidor MCP para gestionar tareas?

No. Para lo básico solo 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 lugar 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 se ajusta a ellos en lugar de escribir una línea de tarea genérica que tus otras herramientas no puedan leer.

¿TaskForge notará las tareas que Claude Code agregue mientras la app está cerrada?

Sí. TaskForge vuelve a leer tu bóveda al abrirse y la vigila en busca de 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 o es irreversible.

¿Esto 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 celular y a tus demás computadoras, igual que lleva las ediciones que haces en Obsidian.

Configuraciones relacionadas

Claude Code es una forma de entrar. La vista general de IA cubre el panorama completo, y las páginas de CLI y MCP profundizan en las superficies de terminal y herramientas.

Tu terminal, tu bóveda, tus tareas.

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