Primeros pasos — instalar InventTasks y configurar un workspace

Instalación y primer inicio#

Instalación y activación#

Descarga inventtasks.zip desde https://inventtasks.solidinvent.pl y descomprímelo en <vault>/.obsidian/plugins/ (el archivo ya contiene la carpeta inventtasks/), o copia una compilación de la versión publicada (main.js, manifest.json, styles.css) en .obsidian/plugins/inventtasks/.
Reinicia Obsidian o recarga los plugins.
Activa InventTasks en Settings → Community plugins.

El archivo INSTALL.md incluido en la descarga contiene instrucciones para gestionar los archivos tanto en escritorio como en dispositivos móviles. Para actualizar una instalación manual, desactiva InventTasks, sustituye los archivos instalados del plugin por los de la nueva versión, recarga Obsidian y vuelve a activar el plugin. Los datos de tus tareas permanecen en la carpeta del workspace dentro del vault.

Abrir InventTasks#

Haz clic en el icono de la cinta de InventTasks (uno por cada workspace/vault configurado).
O ejecuta el comando Open InventTasks desde la paleta de comandos.

La vista principal se abre con el navegador lateral y tu ubicación actual.

Workspace de demostración#

Al iniciarse por primera vez, InventTasks crea la configuración del workspace y sus Lists ocultas del sistema, pero no crea tareas de ejemplo sin avisar. Un workspace vacío ofrece:

Create your first Space, o
Load starter content — un Space, una List y algunos Items de aprendizaje

También puedes usar Settings → InventTasks → Add starter content. Para obtener un ejemplo más amplio con un Space, un Folder, tres Lists, 25 Items activos, campos personalizados, relaciones, Docs, fechas y seguimiento del tiempo, usa Add rich content for testers. Ambas acciones añaden contenido a los datos existentes y respetan los límites del plan gratuito.

Carpeta raíz del workspace por defecto: Tasks/ (cámbiala por vault en los ajustes del plugin).

Workspaces, jerarquía y almacenamiento#

Terminología#

Un vault de Obsidian es la carpeta abierta por Obsidian.
Un workspace de InventTasks es la carpeta raíz del gestor de tareas dentro de ese vault. Los ajustes del plugin también denominan Vaults a estas entradas porque cada una se comporta como una instancia independiente de InventTasks.
Un servidor autoalojado contiene objetos remotos de tipo Task manager o Vault. Un objeto Task manager contiene un workspace de InventTasks; un objeto Vault sincroniza el resto de un vault de Obsidian mediante Vault sync.

Workspaces (Vaults)#

Puedes ejecutar varios workspaces de InventTasks dentro de un solo vault de Obsidian. Cada workspace tiene:

Su propia carpeta raíz que contiene _workspace.md y Spaces
Su propio icono en la cinta y nombre visible
Sus propios ajustes por workspace (zona horaria, estado de notificaciones, copias de seguridad, atajos de teclado, …)

Cambia haciendo clic en un icono de la cinta o mediante Set active en los ajustes. Las cuentas de calendario, la cuenta SMTP y la cuenta ntfy se configuran una sola vez para todo el plugin; los datos de los Items y la configuración Markdown permanecen separados por workspace. También puedes eliminar todos los workspaces de InventTasks y utilizar únicamente el módulo independiente Vault sync.

Jerarquía#

Workspace → Space → (Folder opcional) → List → Item → Subitem

Nivel	En disco	Propósito
Workspace	`_workspace.md`	Valores predeterminados globales: estados, prioridades, campos personalizados, funciones
Space	Carpeta + `_space.md`	Área principal (p. ej. Trabajo, Personal)
Folder	Subcarpeta opcional + `_folder.md`	Agrupa lists dentro de un Space
List	Carpeta + `_list.md`	Contenedor de tareas; cada tarea tiene exactamente una home list
Item	`*.md` en una carpeta List	Una unidad de trabajo
Subitem	Archivo `*.md` separado con `parent_task` en el frontmatter	Subitems directos, o tres niveles totales de árbol cuando están activados los subitems anidados

Docs viven en _docs/ y aparecen en el árbol del sidebar. Las tareas también pueden aparecer en lists adicionales mediante el frontmatter, pero el estado y los campos personalizados siempre provienen de la home list. La pertenencia de una Folder o un Space también está determinada por la home list: un elemento que añades a una List en otro lugar aparece cuando abres esa List — marcado con un badge ↪ que nombra su origen — pero no se cuenta en la Folder o el Space arriba de esa List.

Rutas importantes#

_workspace.md, _space.md, _folder.md, _list.md — configuración
_views/view-*.md — definiciones de vistas guardadas, en el nivel del workspace o de una ubicación
_templates/ — plantillas reutilizables
_trash/ — elementos eliminados de forma reversible
_attachments/<item_id>/ — archivos adjuntos de los Items
_workspace-state.md — estado compartido de notificaciones/sincronización (debe sincronizarse entre dispositivos)
_tasks-calendar.ics — feed ICS opcional en la raíz del workspace de InventTasks

Notas sobre sincronización#

Todos los datos de tareas de InventTasks son Markdown sin formato. Obsidian Sync (o iCloud/Dropbox/Git) puede mantener alineados los Items y la configuración sin necesidad del servidor InventTasks.
Si editas una tarea en el editor de Obsidian mientras InventTasks está abierto, el plugin vuelve a leer al guardar. Evita editar a mano claves estructurales (id, list, IDs de relaciones) a menos que conozcas el esquema.
Sincroniza _workspace-state.md para que el estado leído/pospuesto de la bandeja de entrada y la deduplicación de envíos externos se mantengan coherentes entre dispositivos.
Para las notificaciones externas, utiliza preferiblemente un único equipo de escritorio como emisor activo por vault. Dos equipos que comprueben los avisos al mismo tiempo pueden duplicar mensajes de correo o ntfy antes de que se sincronice el estado compartido.
No sincronices el mismo workspace de InventTasks mediante dos sistemas independientes al mismo tiempo salvo que conozcas sus reglas de conflictos. Por ejemplo, evita usar simultáneamente Obsidian Sync y la sincronización de workspaces de InventTasks sobre los mismos archivos.