DevHelper Dashboard

English · Español

English

A project and task dashboard for Obsidian backed by plain Markdown notes. Your notes are the single source of truth: the plugin never keeps a parallel store, and your own properties and note bodies are preserved on every edit.

The plugin UI is in Spanish.

Website and docs (Spanish): devhelper.didierpiracoca.com/obsidian

Features

• Dashboard view (ribbon icon layout-dashboard or command Abrir el dashboard de proyectos y tareas): favourite project chips, an «All» mode and a per-project view.
• Projects, tasks and notes as Markdown files under Projects/<Project>/ (type: project, type: task, type: note). Create, rename, reassign and toggle tasks between open and done.
• Files per project (Projects/<Project>/Archivos/) plus a shared General project for vault-wide files.
• Encrypted credentials: AES-GCM 256 with a PBKDF2-SHA256 master password (210 000 iterations). Only the service name is stored in clear text; the key lives in memory and auto-locks after a configurable timeout.
• Monthly calendar (Calendario/, type: calendar-event) with date ranges and daily/weekly/monthly/yearly recurrence, expanded virtually — no notes are generated per occurrence.
• Templates (Plantillas/) and Bases (Bases/*.base) seeded on first run so the same data is browsable with Obsidian Bases.
• Two-way sync: manual edits to notes show up in the dashboard immediately.
• Validation issues are listed with an Open note button; one broken note never breaks the rest of the dashboard.
• Deletions always go to Obsidian's trash after confirmation.
• Toolbar buttons (opt-in): notes in Botones/ (type: toolbar-button) become buttons in the dashboard toolbar that run your own JavaScript — a direct action, or a popover with one option per ## heading.

Requires Obsidian 1.9.0 or newer (Bases).

Security and permissions

• Code execution is off by default. Toolbar buttons only run code after you enable Ajustes → DevHelper Dashboard → Botones de la barra → «Permitir botones con código». While it is off, buttons are shown dimmed and nothing is compiled or executed. The code comes only from notes in your own vault; enable it only if you trust those notes (synced or AI-written notes included).
• Shell commands (ctx.run, used by button scripts) go through Node's child_process. It is loaded only on desktop, behind Platform.isDesktopApp, never on mobile, and only runs when a button you enabled calls it. The plugin itself never runs shell commands.
• Vault enumeration: the plugin lists the files in its configured folders (Projects, Calendario, Botones, templates) to build the dashboard, and the dashboard search box lists note paths to open the one you pick. File contents are only read inside those folders.
• Clipboard: written only when you press copy on a credential field; the plugin never reads the clipboard.
• No network access, no telemetry. Credential secrets are encrypted at rest and the derived key never touches disk.

Installation

• Community plugins: Settings → Community plugins → Browse, search for DevHelper Dashboard, or open its store page.
• BRAT: add DidierPiracocaCampos/devhelper-obsidian.
• Manual: download main.js, manifest.json and styles.css from the latest release into <vault>/.obsidian/plugins/devhelper-dashboard/ and enable the plugin.

AI skills (optional)

Each release ships devhelper-skills.zip: ten SKILL.md files (Spanish) that teach AI agents (Claude Code, OpenCode…) the plugin's data model. Unzip them into <vault>/.claude/skills/ or wherever your agent loads skills from.

Companion theme

The dark monochrome DevHelper theme (source) was designed alongside this plugin.

Español

Dashboard de proyectos y tareas para Obsidian respaldado por notas Markdown. Las notas son la única fuente de verdad: el plugin no guarda un almacén paralelo y conserva tus Properties y el cuerpo de las notas en cada edición.

Web y documentación: devhelper.didierpiracoca.com/obsidian

Características

• Vista dashboard (icono layout-dashboard o comando Abrir el dashboard de proyectos y tareas): chips de proyectos favoritos, modo «Todos» y vista por proyecto.
• Proyectos, tareas y notas como archivos Markdown en Projects/<Proyecto>/ (type: project, type: task, type: note). Crear, renombrar, reasignar y alternar tareas entre open y done.
• Archivos por proyecto (Projects/<Proyecto>/Archivos/) y un proyecto sombra General para los archivos globales.
• Credenciales cifradas: AES-GCM 256 con contraseña maestra PBKDF2-SHA256 (210 000 iteraciones). Solo service va en claro; la clave vive en memoria y se bloquea sola tras un tiempo configurable.
• Calendario mensual (Calendario/, type: calendar-event) con rangos y recurrencia diaria/semanal/mensual/anual, expandida en memoria sin crear notas por ocurrencia.
• Plantillas (Plantillas/) y Bases (Bases/*.base) sembradas al primer uso.
• Sincronización bidireccional con las ediciones manuales.
• Avisos de validación con botón Abrir nota; una nota inválida no rompe el resto.
• El borrado siempre va a la papelera de Obsidian, con confirmación.
• Botones de la barra (opcionales): las notas de Botones/ (type: toolbar-button) se convierten en botones de la barra del dashboard que ejecutan tu propio JavaScript, como acción directa o como popover con una opción por cada encabezado ##.

Requiere Obsidian 1.9.0 o superior (Bases).

Seguridad y permisos

• La ejecución de código viene apagada. Los botones sólo ejecutan código si activas Ajustes → DevHelper Dashboard → Botones de la barra → «Permitir botones con código». Mientras esté apagado se ven atenuados y no se compila ni ejecuta nada. El código sale sólo de notas de tu vault: actívalo sólo si confías en ellas (incluidas las sincronizadas o escritas por una IA).
• Comandos de shell (ctx.run, para los scripts de botón) usan child_process de Node. Se carga sólo en escritorio, detrás de Platform.isDesktopApp, nunca en móvil, y sólo se usa cuando un botón que tú activaste lo llama. El plugin por sí mismo no ejecuta comandos.
• Listado del vault: el plugin lista los archivos de sus carpetas configuradas (Projects, Calendario, Botones, plantillas) para montar el dashboard, y la caja de búsqueda del dashboard lista las rutas de las notas para abrir la que elijas. El contenido sólo se lee dentro de esas carpetas.
• Portapapeles: sólo se escribe al pulsar copiar en un campo de credencial; el plugin nunca lo lee.
• Sin red ni telemetría. Los secretos de las credenciales se guardan cifrados y la clave derivada nunca toca el disco.

Instalación

• Complementos de la comunidad: Ajustes → Complementos de la comunidad → Explorar, busca DevHelper Dashboard, o abre su página en la tienda.
• BRAT: añade DidierPiracocaCampos/devhelper-obsidian.
• Manual: descarga main.js, manifest.json y styles.css de la última release en <vault>/.obsidian/plugins/devhelper-dashboard/ y activa el plugin.

Las carpetas (Projects, Plantillas, Calendario, Plantillas/Calendario, Botones) y el tiempo de bloqueo se cambian en Ajustes → DevHelper Dashboard.

Skills de IA (opcional)

Cada release incluye devhelper-skills.zip con diez SKILL.md que enseñan el modelo de datos del plugin a agentes de IA. Descomprímelo en <vault>/.claude/skills/ o donde tu agente cargue skills.

Theme

El theme oscuro monocromo DevHelper (código) se diseñó junto a este plugin.

Desarrollo

Requisitos: Node.js ≥ 18.

npm install
npm run dev        # watch con esbuild
npm run build      # build de producción → main.js + skills/
npm run typecheck
npm test

Publicar una versión:

npm version patch                     # sube package.json, manifest.json y versions.json
git push origin master --follow-tags  # el tag dispara la release en GitHub Actions

License / Licencia

MIT © Didier Piracoca