adc-drive-agent

Agente CLI del túnel de ADC Drive: monta carpetas locales (visibles desde tus otros dispositivos), monta unidades S3/WebDAV y autodescarga carpetas de transferencia, sin pestaña de navegador abierta.

Un solo archivo, sin dependencias. Corre en Node ≥ 20 y en Bun.

Uso

# 1. Generar el código en Drive → Dispositivos → "Vincular agente CLI"
npx @adigitalcafe/adc-drive-agent pair ABCD2345 --name "Mi PC"
#   o: bunx @adigitalcafe/adc-drive-agent pair ABCD2345 --name "Mi PC"

npx @adigitalcafe/adc-drive-agent mount ~/Compartida --rw   # rw = lectura y escritura
npx @adigitalcafe/adc-drive-agent remote-mount <unitId>     # unidad S3/WebDAV (la conexión la inicia este agente)
npx @adigitalcafe/adc-drive-agent subscribe <folderId> ~/Descargas/drive
npx @adigitalcafe/adc-drive-agent run                       # mantenerlo conectado (pide passphrase si la unidad es E2E)

run es el que hace el trabajo: atiende los pedidos de tus otros dispositivos y baja lo que caiga en las carpetas suscritas. Dejalo corriendo (systemd, launchd o una terminal). Tras mount, remote-mount o subscribe hay que reiniciarlo para que anuncie los cambios.

Para no escribir npx cada vez: npm i -g @adigitalcafe/adc-drive-agent y después adc-drive-agent <comando>.

Comandos

| Comando | Qué hace | | --- | --- | | pair <código> [--url <base>] [--name <nombre>] | Vincula este equipo (código de un solo uso) | | mount <ruta> [--rw] | Expone una carpeta local (por defecto, solo lectura) | | unmount <mountId\|nombre> | Deja de exponerla | | remote-mount <unitId> [--name <nombre>] | Monta una unidad S3/WebDAV ya creada en Drive | | remote-unmount <id\|nombre\|unitId> | Desmonta la unidad | | subscribe <folderId> <carpetaLocal> | Autodescarga de una carpeta de transferencia | | unsubscribe <folderId> | Quita la suscripción | | status | Muestra montajes y suscripciones | | run | Se conecta y queda escuchando |

Qué guarda y qué manda

• Config y device token en ~/.config/adc-drive-agent.json (chmod 600). El token sólo sirve para los endpoints del túnel y se revoca desde Drive → Dispositivos.
• Se conecta únicamente al servidor que le indiques: por defecto https://drive.adigitalcafe.com, cambiable con --url al vincular.
• Los archivos de las carpetas montadas no se suben: viajan sólo cuando otro de tus dispositivos los pide, y la plataforma hace de puente sin guardarlos.
• En una unidad remota con passphrase, la plataforma nunca ve las credenciales en claro: el agente descifra el blob localmente y te pide la passphrase al arrancar.

Licencia

Apache-2.0 (ver LICENSE). La licencia no concede derechos sobre las marcas "ADC" ni "A Digital Cafe".

connectors/ (S3 SigV4, WebDAV y cifrado por passphrase, ESM sin dependencias) es el mismo código que usa el agente del navegador.