#17 ¿Puedo vincular una carpeta local?
Sí — y es muy potente. Vincula un directorio de proyecto y PenPage se convierte en un editor en vivo para todo tu árbol de carpetas. Subcarpetas, archivos anidados, configuraciones de agents AI — todo se sincroniza en ambas direcciones, automáticamente.
Dos formas de vincular
- Cualquier carpeta — clic derecho en una carpeta → Link Directory para conectarla a una carpeta en disco.
- Workspace Directory (🗂️) — un workspace completo dedicado a carpetas locales y de red, mantenido separado de tus otras notas. (#6 ¿Qué son los Workspaces?)
Ambos usan la misma sincronización bidireccional descrita a continuación.
Vincular un árbol de directorios completo
File Link no solo conecta un archivo — conecta un directorio completo, incluyendo subcarpetas hasta 4 niveles de profundidad. Cada archivo .md se convierte en una página de PenPage. Cada subdirectorio se convierte en una carpeta anidada de PenPage.
- Haz clic en el icono de enlace en una carpeta (o clic derecho → Link Directory)
- Selecciona un directorio de tu computadora
- PenPage escanea el árbol y muestra un selector de subcarpetas — elige cuáles incluir
- Listo — tu árbol de directorios ahora está en vivo en PenPage
Un enlace, todo tu proyecto AI
Aquí es donde se pone emocionante. Vincula la raíz de tu proyecto y PenPage descubre automáticamente todos los archivos .md que tus herramientas AI usan:
| Herramienta AI | Lo que PenPage encuentra |
|---|---|
| Claude Code | CLAUDE.md, .claude/agents/, .claude/rules/, .claude/plans/ |
| Gemini CLI | GEMINI.md y configuración relacionada |
| Codex CLI | AGENTS.md y definiciones de agents |
Un enlace → agents, rules, plans, skills, prompts — todo editable en el editor enriquecido de PenPage. La AI lee tus cambios al instante. Sin copiar y pegar, sin cambiar de ventana.
Ve #16 AI Coding Agent para el flujo completo de editar-ejecutar-sincronizar.
Sincronización bidireccional
Cada cambio se sincroniza en ambas direcciones — PenPage al disco, disco a PenPage.
| Evento | Qué sucede |
|---|---|
| Editar una página en PenPage | El archivo en disco se actualiza automáticamente |
| Editar un archivo en disco | PenPage recoge el cambio en la siguiente sincronización |
| Ambos lados cambiaron | Auto-fork — crea dos versiones, sin datos perdidos |
| Archivo eliminado en disco | Página movida a la Papelera |
| Página eliminada en PenPage | Archivo .md eliminado del disco |
¿Cuándo se sincroniza?
- Cambio de página: la página actual se sincroniza inmediatamente
- Foco en la pestaña: vuelves a PenPage → todas las carpetas vinculadas se re-escanean
- En segundo plano: escaneo periódico cada 60 segundos
- Manual: clic derecho en la carpeta → Sync Directory
¿Conflicto? PenPage nunca sobreescribe ningún lado. Si ambos cambiaron, crea dos versiones — tú decides cuál conservar.
Modo proyecto AI: Cuando PenPage detecta un directorio .penpage, los cambios de archivo siempre ganan en conflictos — así la salida de tu herramienta AI nunca es sobreescrita por una copia obsoleta de PenPage.
Link Update — descubrir nuevas subcarpetas
¿Agregaste nuevos directorios después de vincular? Clic derecho en la carpeta vinculada → Link Update. PenPage escanea nuevos subdirectorios y ofrece vincularlos — no necesitas desvincular y volver a vincular.
Desvincular
¿Quieres desconectar? Clic derecho en la carpeta → Unlink Directory.
- Las páginas se quedan en PenPage — nada se elimina
- Los archivos en disco quedan intactos
- Solo se elimina la conexión de sincronización en vivo
- Puedes volver a vincular el mismo directorio en cualquier momento
Deduplicación inteligente
PenPage usa hashing de contenido para prevenir duplicados:
- ¿Vinculas un directorio que se superpone con páginas existentes? Los duplicados se detectan y se omiten
- El re-escaneo encuentra y limpia automáticamente archivos
.mdduplicados - Los archivos
.mdvacíos (de páginas que nunca editaste) se eliminan automáticamente
Requisitos del navegador
File Link requiere la File System Access API:
| Navegador | Soporte |
|---|---|
| Chrome / Edge (escritorio) | Soporte completo — recomendado |
| Safari / Firefox | No disponible |
| Navegadores móviles | No disponible |
Tu navegador recuerda a qué directorios les diste acceso. Después de reiniciar, PenPage verifica los permisos silenciosamente — sin diálogo de re-autorización en la mayoría de los casos.
Si solo quieres tomar notas...
File Link está diseñado para usuarios avanzados y desarrolladores. Si solo estás escribiendo notas:
- El almacenamiento integrado de PenPage es más simple y rápido
- Para acceso multi-dispositivo, usa Cloud Sync (#12)
- Para backups, usa la función de guardar/restaurar con un clic (#7)
Tipos de archivo soportados
Solo .md y .markdown. Los archivos ocultos (que empiezan con .) se omiten.