#17 Posso Vincular uma Pasta Local?
Sim — e é poderoso. Vincule um diretório de projeto e o PenPage vira um editor ao vivo pra toda a árvore de pastas. Sub-pastas, arquivos aninhados, configs de agentes de IA — tudo sincroniza nos dois sentidos, automaticamente.
Duas maneiras de vincular
- Qualquer pasta — clique com botão direito numa pasta → Link Directory pra conectá-la a uma pasta no disco.
- Directory workspace (🗂️) — um workspace inteiro dedicado a pastas locais e de rede, mantido separado das suas outras notas. (#6 O que são Workspaces?)
Ambos usam a mesma sincronização bidirecional descrita abaixo.
Vincule uma árvore de diretórios inteira
File Link não conecta só um arquivo — conecta um diretório inteiro, incluindo sub-pastas até 4 níveis de profundidade. Cada arquivo .md vira uma página no PenPage. Cada sub-diretório vira uma pasta aninhada.
- Clique no ícone de link numa pasta (ou clique com botão direito → Vincular Diretório)
- Selecione um diretório do seu computador
- O PenPage escaneia a árvore e mostra um seletor de sub-diretórios — escolha quais incluir
- Pronto — sua árvore de diretórios está ao vivo no PenPage
Um vínculo, seu projeto inteiro de IA
Aqui é onde fica empolgante. Vincule a raiz do seu projeto e o PenPage descobre automaticamente todos os arquivos .md que suas ferramentas de IA usam:
| Ferramenta de IA | O que o PenPage encontra |
|---|---|
| Claude Code | CLAUDE.md, .claude/agents/, .claude/rules/, .claude/plans/ |
| Gemini CLI | GEMINI.md e configs relacionadas |
| Codex CLI | AGENTS.md e definições de agentes |
Um vínculo → agentes, regras, planos, skills, prompts — tudo editável no editor rico do PenPage. A IA lê suas alterações na hora. Sem copiar e colar, sem alternar janelas.
Veja #16 Agente de IA para Código pro fluxo completo de edição-execução-sincronização.
Sincronização bidirecional
Cada alteração sincroniza nos dois sentidos — PenPage pro disco, disco pro PenPage.
| Evento | O que acontece |
|---|---|
| Edita uma página no PenPage | Arquivo no disco atualiza automaticamente |
| Edita um arquivo no disco | PenPage detecta na próxima sincronização |
| Ambos os lados mudaram | Auto-fork — cria duas versões, sem perda de dados |
| Arquivo deletado no disco | Página vai pra Lixeira |
| Página deletada no PenPage | Arquivo .md removido do disco |
Quando a sincronização acontece?
- Troca de página: página atual sincroniza imediatamente
- Foco na aba: volta pro PenPage → todas as pastas vinculadas reescaneiam
- Em segundo plano: reescaneamento periódico a cada 60 segundos
- Manual: clique com botão direito na pasta → Sincronizar Diretório
Conflito? O PenPage nunca sobrescreve nenhum lado. Se ambos mudaram, cria duas versões — você decide qual manter.
Modo projeto de IA: Quando o PenPage detecta um diretório .penpage, alterações no arquivo sempre vencem em conflitos — então a saída da sua ferramenta de IA nunca é sobrescrita por uma cópia desatualizada do PenPage.
Atualização de vínculo — descubra novas sub-pastas
Adicionou novos diretórios ao projeto depois de vincular? Clique com botão direito na pasta vinculada → Atualizar Vínculo. O PenPage escaneia por novos sub-diretórios e oferece vinculá-los — sem precisar desvincular e revincular.
Desvincular
Quer desconectar? Clique com botão direito na pasta → Desvincular Diretório.
- Páginas ficam no PenPage — nada é deletado
- Arquivos no disco ficam intocados
- Só a conexão de sincronização ao vivo é removida
- Você pode revincular o mesmo diretório quando quiser
Deduplicação inteligente
PenPage usa hash de conteúdo pra prevenir duplicatas:
- Vinculando um diretório que se sobrepõe a páginas existentes? Duplicatas são detectadas e ignoradas
- Reescaneamento encontra e limpa arquivos
.mdduplicados automaticamente - Arquivos
.mdvazios (de páginas que você nunca editou) são removidos automaticamente
Requisitos do navegador
File Link requer a File System Access API:
| Navegador | Suporte |
|---|---|
| Chrome / Edge (desktop) | Suporte completo — recomendado |
| Safari / Firefox | Não disponível |
| Navegadores mobile | Não disponível |
Seu navegador lembra quais diretórios você autorizou. Depois de reiniciar, o PenPage verifica permissões silenciosamente — sem diálogo de re-autorização na maioria dos casos.
Se você só quer fazer anotações...
File Link foi feito pra usuários avançados e desenvolvedores. Se você só quer escrever notas:
- O armazenamento nativo do PenPage é mais simples e rápido
- Pra acesso entre dispositivos, use Cloud Sync (#12)
- Pra backup, use o Salvar/Restaurar com um clique (#7)
Tipos de arquivo suportados
Apenas .md e .markdown. Arquivos ocultos (começando com .) são ignorados.