Web

ArmIn puo funzionare come applicazione web nel browser, offrendo la stessa potente esperienza di coding AI senza bisogno di un terminale.

Per iniziare

Avvia l’interfaccia web eseguendo:

armin web

Questo avvia un server locale su 127.0.0.1 con una porta disponibile scelta a caso e apre automaticamente ArmIn nel browser predefinito.

Attenzione

Se OPENCODE_SERVER_PASSWORD non e impostata, il server non sara protetto. Va bene per l’uso locale, ma va impostata per l’accesso in rete.

Utenti Windows

Per la migliore esperienza, esegui armin web da WSL invece che da PowerShell. Questo garantisce accesso corretto al file system e integrazione col terminale.

---

Configurazione

Puoi configurare il server web con i flag della riga di comando o nel tuo file di config.

Porta

Per impostazione predefinita, ArmIn sceglie una porta disponibile. Puoi specificare una porta:

armin web --port 4096

Nome host

Per impostazione predefinita, il server si lega a 127.0.0.1 (solo localhost). Per rendere ArmIn accessibile sulla rete:

armin web --hostname 0.0.0.0

Usando 0.0.0.0, ArmIn mostrera sia l’indirizzo locale sia quello di rete:

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

Scoperta mDNS

Abilita mDNS per rendere il server individuabile sulla rete locale:

armin web --mdns

Questo imposta automaticamente l’hostname a 0.0.0.0 e pubblicizza il server come armin.local.

Puoi personalizzare il nome di dominio mDNS per eseguire piu istanze sulla stessa rete:

armin web --mdns --mdns-domain myproject.local

CORS

Per consentire domini aggiuntivi per CORS (utile per frontend personalizzati):

armin web --cors https://example.com

Autenticazione

Per proteggere l’accesso, imposta una password usando la variabile d’ambiente OPENCODE_SERVER_PASSWORD:

OPENCODE_SERVER_PASSWORD=secret armin web

Lo username predefinito e armin, ma puo essere cambiato con OPENCODE_SERVER_USERNAME.

---

Usa l’interfaccia web

Una volta avviata, l’interfaccia web ti da accesso alle tue sessioni ArmIn.

Sessioni

Visualizza e gestisci le sessioni dalla homepage. Puoi vedere le sessioni attive e avviarne di nuove.

Stato del server

Fai clic su “See Servers” per vedere i server connessi e il loro stato.

---

Collegare un terminale

Puoi collegare una TUI da terminale a un server web gia in esecuzione:

# Avvia il web server
armin web --port 4096

# In un altro terminale, collega la TUI
armin attach http://localhost:4096

Questo ti permette di usare contemporaneamente interfaccia web e terminale, condividendo le stesse sessioni e lo stesso stato.

---

File di configurazione

Puoi anche configurare le impostazioni del server nel file di config armin.json:

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

I flag della riga di comando hanno precedenza sulle impostazioni del file di config.