Repository navigation
it AI AGENTS
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
Un endpoint SSH sempre attivo trasforma il tuo telefono in qualcosa che un agente AI autonomo può operare direttamente. Qualsiasi agente in grado di pilotare una shell o una connessione SSH (Claude Code, aider, uno script LLM-in-the-loop, la tua automazione personale) ottiene una vera sessione root sul dispositivo, via rete, senza cavo USB e senza alcuno dei flag di debug di ADB che si espongono da soli.
Questa pagina approfondisce l'idea introdotta nel README.
ADB si annuncia da solo: adb_enabled e development_settings_enabled sono leggibili da chiunque, la
connessione viene registrata e non esiste alcun modo supportato per nascondere che il debug è (o era)
attivo. Un agente che lavora tramite ADB lascia quella traccia sul dispositivo, leggibile da qualsiasi
app o SDK antifrode. VD Dropbear è l'alternativa privata: un normale accesso SSH, con credenziali che
controlli tu e un banner che non rivela nulla.
Su un'unica connessione, un agente vede una normale shell in stile Linux e può:
- leggere e modificare file, cambiare impostazioni e gestire moduli, pacchetti e servizi;
- analizzare i log, estrarre artefatti ed eseguire diagnostica o analisi forensi su richiesta;
- spostare e sincronizzare file in entrambe le direzioni tramite
scp/sftp/rsync: backup, migrazioni, provisioning; - pilotare un'intera flotta di dispositivi con root da un unico punto, ciascuno raggiungibile con la propria chiave.
Poiché il progetto è costruito per essere AI-friendly (un file di configurazione documentato, un esplicito env contract di runtime, percorsi prevedibili e stato in testo semplice), un agente può scoprire come usarlo senza tirare a indovinare.
Questo è root, quindi trattalo come root:
- assegna all'agente una credenziale propria, non quella personale, e indirizzalo a un account con privilegi inferiori (
shell) se vuoi limitarne la portata; - limita i bind alle reti di cui ti fidi: loopback o una VPN anziché l'Internet aperto (vedi Configuration);
- tieni disattivata l'autenticazione con password; una chiave è revocabile e non viene mai digitata;
- puoi revocare una chiave o fermare il daemon in qualsiasi momento dalla WebUI;
- ricorda che una connessione predefinita è una sessione root completa: concedi all'agente solo la portata di cui ha bisogno.
- Genera una coppia di chiavi solo per l'agente.
- Aggiungi la sua chiave pubblica nella WebUI (Authorized keys).
- Fai il bind solo su loopback o sulla tua VPN, su una porta non predefinita.
- Punta la configurazione SSH dell'agente al dispositivo e lascialo lavorare.
Via USB, senza ADB: attiva il tethering USB e lega all'indirizzo USB per un collegamento solo via cavo, comodo per un agente su un laptop collegato. Vedi la guida utente.
Questa documentazione è stata generata con Claude (Anthropic) ed è gestita da VD171. Correzioni e miglioramenti sono benvenuti; vedi CONTRIBUTING.md.