rdev include un profilo dell'agente AI già pronto, così i tuoi agenti sanno come funziona l'ambiente fin dal primo giorno.
Agenti supportati
| Agente | Supporto |
|---|---|
| Claude Code | Completo |
| Codex | Completo |
| opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI | Completo |
| Cursor CLI, Antigravity CLI | Standard |
Altri agenti che leggono AGENTS.md e parlano MCP |
Standard, installati da te |
Supporto completo significa che il programma di installazione, il profilo, le impostazioni gestite, le notifiche, lo stato delle sessioni e gli aggiornamenti coprono l'agente. Supporto standard significa che l'agente riceve le regole condivise e l'accesso MCP, senza extra specifici per l'agente. La scheda Agenti del pannello mostra il livello accanto a ogni agente.
Installare gli agenti
Apri il server da Server nella barra laterale, poi Agenti. La scheda Agenti AI elenca ogni agente che rdev conosce, se è installato e in quale versione, e il comando che lo avvia (copialo con il pulsante accanto). Installa aggiunge un agente, e il menu ⋯ ne aggiorna o ne rimuove uno. Codex fa parte dell'immagine dell'ambiente e non può essere rimosso. Le modifiche vengono eseguite sul server e richiedono da pochi secondi a un minuto; la scheda mostra il risultato quando ha finito.
Gli agenti sono per ambiente: in un piano Team ogni membro sceglie gli agenti per il proprio ambiente, e installarne uno non cambia quello di nessun altro. Serve rdev 0.2.0-beta.36 o successivo; finché il server non lo esegue, la scheda ti chiede di aggiornare.
Aggiornare gli agenti
Gli agenti non si aggiornano da soli sul tuo server e dentro un agente non vedi mai l'avviso «aggiornamento installato, riavvia». Aggiornali dal menu ⋯ o con rdev agents update (un solo agente: rdev agents update claude). Quando la versione cambia, rdev riapre ogni sessione inattiva di quell'agente con la nuova versione: nella stessa finestra di terminale, nella stessa conversazione, con la sua cronologia. Una sessione il cui agente sta lavorando o aspetta la tua risposta non viene mai interrotta; resta sulla vecchia versione finché non la riavvii. Le sessioni di Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI e Gemini CLI vengono riaperte; quelle di Cursor CLI e Antigravity CLI restano sulla vecchia versione finché non le riavvii. Serve rdev 1.1.5 o successivo.
Altri modelli: chiavi dei provider e scorciatoie
Gli agenti possono anche usare modelli di altri provider. In Chiavi dei provider di modelli nella stessa scheda, Aggiungi chiave memorizza una chiave API per Anthropic, OpenAI, Google Gemini, DeepSeek, Kimi (Moonshot), GLM (Z.ai), MiniMax, Qwen (Alibaba), OpenRouter, Groq, xAI o Mistral. Per Ollama inserisci l'indirizzo del tuo server Ollama (http://… o https://…) invece di una chiave. La chiave viene cifrata nel tuo browser per questo server: il pannello non la vede mai, non può mostrarla di nuovo e sa solo quali provider ne hanno una. Aggiungere una chiave per un provider che ne ha già una la sostituisce.
Una volta impostata una chiave, scorciatoie già pronte avviano in un progetto un agente sui modelli di quel provider:
| Scorciatoie | Provider |
|---|---|
claude-deepseek, claude-kimi, claude-glm, claude-minimax, claude-qwen |
Claude Code sui modelli DeepSeek, Kimi, GLM, MiniMax o Qwen |
codex-deepseek, codex-openrouter, codex-groq, codex-xai, codex-ollama |
Codex sui modelli DeepSeek, OpenRouter, Groq, xAI o Ollama |
qwen-<provider>, come qwen-openrouter |
Qwen Code sui modelli di un altro provider |
La scheda elenca le scorciatoie rese pronte dalle tue chiavi. Claude Code con modelli diversi da Claude non è ufficialmente supportato da Anthropic: funziona per la maggior parte delle attività, ma alcune funzionalità potrebbero comportarsi diversamente.
Regole condivise
Le regole che ogni agente segue vivono in un unico posto, AGENTS.md. Codex, Gemini CLI e opencode lo leggono direttamente, e Claude Code lo include dal proprio CLAUDE.md. Le parti specifiche degli agenti, come le skill e gli hook di Claude Code, si appoggiano a queste regole condivise.
Quanta parte del profilo ottieni dipende dal tuo piano:
- Single: regole di base.
- Pro: il profilo completo con skill, agenti e instradamento dei modelli.
- Team: il profilo completo più le regole di team condivise.
Il profilo completo aggiunge skill di Claude Code per Laravel, WordPress, debug e deploy in questo ambiente; un subagente frontend che svolge il lavoro visivo su un modello più veloce ed economico mentre la sessione principale tiene le parti difficili (questo è l'instradamento dei modelli); e un subagente reviewer per una revisione indipendente prima che una modifica sia conclusa. Le regole del team si scrivono nella pagina Team. Se passi a Single, i file del profilo completo vengono rimossi a meno che tu non li abbia modificati.
La guida ai comandi rdev
Ogni piano installa una skill rdev per ogni agente di programmazione che usi. È una breve guida che dice all'agente quale comando rdev o quale strumento MCP di rdev gestisce un compito: aggiungere ed eseguire progetti, installare versioni di linguaggi, PHP e Node, database e servizi, mantenere in esecuzione worker e attività pianificate, anteprime, checkpoint, accesso a Git, backup, deploy, tracciamento degli errori, notifiche e la licenza. Gli agenti la caricano da soli quando un compito ne ha bisogno, quindi puoi semplicemente chiedere, per esempio, "aggiungi un database Postgres a shop" o "avvia il worker delle code per blog".
Viene installata in ~/.claude/skills/rdev (Claude Code) e ~/.agents/skills/rdev (Codex, opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI e Cursor), e in ~/.gemini/config/skills/rdev quando Antigravity è installato. rdev mantiene questi file aggiornati; metti le tue skill in altre cartelle.
Accesso MCP
Gli agenti ottengono accesso MCP ai tuoi siti e database. Questo permette a un agente di creare un sito, aggiungere Redis, un database, la ricerca o l'archiviazione S3 a un progetto, installare un'estensione PHP come mongodb quando composer la richiede, consultare un database o leggere le email catturate da solo, invece di chiedere a te di farlo.
Da rdev 0.2.0-beta.34 gli agenti gestiscono anche i processi e le attività pianificate di ogni progetto: dopo aver scritto un job in coda, un agente configura da solo il queue worker o lo scheduler di Laravel, riavvia un worker dopo aver modificato il codice che esegue e legge l'output di un processo. Legge la parte finale del log di Laravel o il suo ultimo errore quando una richiesta fallisce, elenca, crea e ripristina checkpoint (più sotto), condivide un sito come anteprima quando glielo chiedi e ti dice se il backup notturno è stato eseguito. Claude Code ti chiede conferma prima di usare uno strumento per la prima volta, come per qualsiasi altro strumento MCP.
Il tuo account
Colleghi il tuo account Anthropic o OpenAI, oppure le chiavi dei provider qui sopra. L'uso degli agenti è fatturato da quei provider e non è incluso nel tuo abbonamento rdev. Non vediamo mai i tuoi prompt né il tuo utilizzo.
Far girare gli agenti a ciclo continuo
Dai il prompt all'agente e lascialo lavorare sul tuo server; tu chiudi il laptop e ti godi la giornata. Gli agenti girano sul tuo server, non sul tuo laptop, quindi un lavoro che richiede ore continua anche dopo che te ne sei andato.
Ogni accesso SSH al tuo server apre la stessa sessione persistente, chiamata main: il Terminal on the server dell'app del laptop, ssh rdev o un'app SSH su telefono o tablet. Non devi avviarla tu (rdev 1.0.1 o successivo).
Open in Terminal di un progetto nell'app del portatile e rdev open <progetto> aprono invece la sessione persistente propria di quel progetto, con il suo nome e avviata nella sua cartella. Così ogni progetto mantiene le proprie finestre e i propri agenti, e due dispositivi su progetti diversi non cambiano mai la vista dell'altro (rdev 1.3.1 o successivo).
- Avvia l'agente in quel terminale e dagli il compito.
- Chiudi lo schermo, chiudi l'app o lascia cadere la connessione. L'agente continua a lavorare sul server. Per uscire di proposito, premi Ctrl-b e poi d.
- Torna da qualsiasi dispositivo: accedi di nuovo e sei nella stessa sessione, dove l'avevi lasciata. Sessioni degli agenti nel pannello e le tue notifiche ti dicono quando il lavoro è finito o ti sta aspettando.
Alcuni tasti aiutano: Ctrl-b c apre una nuova finestra (per un secondo agente), Ctrl-b n e Ctrl-b p si spostano tra le finestre, e puoi scorrere con il mouse o il trackpad. Per disattivare la sessione persistente, esegui rdev session persist off sul server (on la riattiva; rdev 1.0.5 o successivo); i terminali remoti del tuo editor (VS Code, Cursor) e la sincronizzazione dei file non la usano mai.
Quando una sessione è terminata, continua la stessa conversazione con il comando dell'agente stesso, come claude --continue (o claude --resume per sceglierne una) e codex resume. Le conversazioni restano sul tuo server, nella tua cartella home, attraverso aggiornamenti e riavvii.
rdev host update riavvia l'ambiente, il che ferma ogni agente e ogni sessione persistente. Aspetta finché un agente lavora o ti aspetta, e te lo dice; rdev host update --force aggiorna comunque.
Sessioni degli agenti nel pannello
Sessioni degli agenti nel pannello elenca le sessioni di Claude Code e Codex sui tuoi server e cosa sta facendo ciascuna: In esecuzione, In attesa di te (una richiesta di permesso o una domanda), Terminato o Fermato da un errore. Si aggiorna ogni pochi secondi e funziona su un telefono, così puoi controllare un'attività lunga da qualsiasi luogo. Le sessioni in attesa di te vengono per prime.
Al pannello arrivano solo l'agente, la sessione, il nome della cartella del progetto e lo stato; mai i tuoi prompt, le risposte dell'agente o il tuo codice. Le sessioni vengono conservate per una settimana. Codex segnala In esecuzione e Terminato; le sue richieste di approvazione non compaiono ancora.
Il menu ⋯ su una sessione ferma una sessione in esecuzione: il server termina il processo dell'agente in pochi secondi (i file già modificati restano e il checkpoint dall'inizio della sessione può annullarli; serve rdev 0.2.0-beta.36 o successivo). Una sessione che gira in un terminale persistente mostra un badge Persistente, e Chiudi finestra del terminale nel suo menu ferma l'agente se sta ancora lavorando e chiude la sua finestra di terminale sul server, anche dopo che l'agente ha finito (rdev 1.0.1 o successivo). Rimuovi dall'elenco nasconde una sessione, e Cancella terminate rimuove in una volta ogni sessione terminata, fallita o inattiva; una sessione che segnala di nuovo ritorna. Apri nel terminale web apre quella finestra di terminale nel terminale web del tuo server da un dispositivo della tua tailnet (solo sui tuoi server, rdev 1.4.5 o successivo); se la finestra non esiste più, si apre la tua solita sessione persistente.
Checkpoint: annulla ciò che ha fatto un agente
Quando inizia un turno di un agente in un progetto git, rdev salva prima un checkpoint dei file del progetto: file tracciati e nuovi, non quelli ignorati. È un commit fuori dai tuoi branch, quindi git status, la tua cronologia e il tuo stash restano uguali. Ogni progetto conserva i suoi ultimi 20 checkpoint; un turno che non ha cambiato nulla non ne aggiunge.
I checkpoint automatici prima di ogni turno arrivano dagli hook dell'agente, quindi Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI e Gemini CLI li hanno da soli. Cursor CLI e Antigravity CLI non hanno questi hook; ottengono i checkpoint quando li avvii tramite rdev, che mostra anche la sessione nel pannello e ti avvisa quando finisce:
rdev agents run cursor
Per Antigravity CLI usa rdev agents run antigravity.
Per annullare, apri il tuo server nel pannello e scegli un checkpoint in Annulla e ripristina, oppure sul server. Elenca i checkpoint del progetto:
rdev checkpoint list
Poi ripristinane uno tramite il suo id:
rdev checkpoint restore 1793603600
Il ripristino rimette i file com'erano ed elimina i file aggiunti da allora; lo stato attuale viene prima salvato come nuovo checkpoint (a meno che non coincida già con il più recente), quindi anche un ripristino può essere annullato. rdev checkpoint create ne salva uno a mano. I checkpoint richiedono rdev 0.2.0-beta.16 o successivo.