Quick Start
Parti in 30 secondi. Scarica, installa e lancia la tua prima sessione AI.
1. Scarica e installa
Scarica PromptOps Manager dalla pagina Download. Disponibile per macOS, Windows e Linux. L'installer si occupa di tutto — non serve configurare nulla.
2. Accedi o registrati
Crea un account o accedi con le tue credenziali. La verifica email avviene con un codice OTP a 6 cifre. Il tuo device viene registrato automaticamente per la sicurezza.
3. Collega un workspace
Seleziona la directory del tuo progetto. PromptOps rileva automaticamente la struttura, il linguaggio, i file di configurazione e le connessioni database. Il workspace viene associato al tuo device.
4. Lancia una sessione
Scegli un provider AI (Claude, Codex, Gemini, Copilot o Shell), scrivi un prompt e l'agente inizia a lavorare. Output in tempo reale nel terminale integrato.
Consiglio: con Claude Pro/Max ottieni l'esperienza completa — sub-agent, extended thinking e contesto fino a 1M token.
Sessioni
Le sessioni sono il cuore di PromptOps Manager. Ogni sessione e un ambiente isolato con il suo provider AI, terminale e contesto.
Creare una sessione
Clicca "Nuova sessione" o usa la shortcut. Seleziona il provider AI desiderato e il workspace. Ogni sessione ha il proprio processo terminale isolato.
Sessioni multiple
Puoi avere piu sessioni attive sullo stesso workspace. Ogni sessione ha il suo terminale, il suo contesto e il suo stato indipendente. Passa tra le sessioni con i tab nella barra superiore.
Ciclo di vita
Le sessioni vengono salvate automaticamente ogni 30 secondi. In caso di crash o chiusura accidentale, la sessione viene ripristinata automaticamente all'avvio successivo. Puoi anche creare template riutilizzabili per sessioni frequenti.
Cronologia sessione
Ogni azione all'interno di una sessione e tracciata: spawn, prompt, output, merge, errori. La cronologia e persistente sul backend e visualizzata come una timeline in stile git.
Smart Context Injection
All'avvio di ogni sessione, il workspace viene analizzato e una mappa del progetto (struttura, entry point, file recenti) viene iniettata nel contesto dell'agente. Risparmio stimato: 30K-100K token per sessione.
Sub-Agent
I sub-agent sono agenti AI specializzati che lavorano in parallelo sotto la supervisione dell'agente principale.
Ruoli disponibili
Ogni sub-agent ha un ruolo predefinito con un system prompt dedicato:
- Security Audit — analisi di vulnerabilita, revisione codice per falle di sicurezza
- Test Runner — generazione e esecuzione di test unitari e di integrazione
- Code Review — revisione del codice per qualita, best practice e manutenibilita
- Documentation — generazione e aggiornamento della documentazione del progetto
- Refactoring — ristrutturazione del codice per migliorare leggibilita e performance
- Performance — analisi di bottleneck e ottimizzazione delle performance
Spawn e gestione
Un click spawna un sub-agent dal pannello Quick Agents. Ogni sub-agent riceve il proprio terminale dedicato, il proprio contesto ottimizzato (con i file realmente modificati da git diff) e istruzioni di scope ridotto.
Comunicazione inter-agent
Gli agenti comunicano tra loro automaticamente tramite l'Agent Relay. L'agente principale modifica un file, l'agent Security lo revisiona, l'agent Test aggiorna i test. Message passing asincrono con acknowledgment.
Merge dei risultati
I risultati di ogni sub-agent vengono raccolti e presentati nella timeline della sessione principale. Puoi ispezionare l'output di ciascun sub-agent individualmente.
Provider AI
PromptOps supporta 5 provider AI, ognuno con le sue caratteristiche. Puoi cambiare provider per sessione o per singolo sub-agent.
Claude Code
RecommendedL'integrazione piu profonda. Sub-agent paralleli illimitati, extended thinking, contesto fino a 1M token. Richiede piano Anthropic Pro o Max. Esperienza consigliata.
OpenAI Codex
Generazione codice multi-file con output in streaming. Prompt library, tracking sessioni e cronologia persistente.
Gemini CLI
Analisi di codebase con contesto ampio. Gestione sessioni, versionamento prompt e condivisione nel team.
GitHub Copilot
Completamenti inline e suggerimenti contestuali. Integrazione con workflow PR e generazione comandi terminale.
Cursor CLI
L'editor AI-first portato in PromptOps. Sessioni gestite, sub-agent paralleli e prompt library condivisa, mantenendo il workflow Cursor che gia conosci.
OpenCode
CLI di coding open-source e local-first. Spawn diretto del comando opencode con tracking sessione, prompt library e contesto progetto materializzato.
Shell / CLI personalizzato
Qualsiasi tool CLI come provider. Script custom, automazione e accesso terminale completo con logging integrato.
Per cambiare provider, apri le impostazioni della sessione e seleziona il provider desiderato. Il cambio e istantaneo e non interrompe la sessione.
Prompt Library
La Prompt Library e il sistema di gestione strutturata dei prompt. Ogni prompt e un asset versionato, forkabile e condivisibile.
Creare un prompt
Crea un nuovo prompt con titolo, contenuto, categoria e tag. Puoi aggiungere variabili dinamiche con la sintassi {{variabile}} per rendere il prompt riutilizzabile su qualsiasi progetto.
Versionamento
Ogni modifica a un prompt crea una nuova versione. Puoi confrontare le versioni con il diff viewer e ripristinare una versione precedente in qualsiasi momento.
Fork e condivisione
Forka il prompt di un collega per personalizzarlo. La catena di derivazione viene tracciata automaticamente. Puoi condividere i prompt con il team — le change request passano per un flusso di approvazione simile a una pull request.
Generatore AI
Genera prompt strutturati a partire da una descrizione del task. Il generatore crea automaticamente titolo, contenuto, variabili e template.
Git Integrato
PromptOps integra un sistema git completo nella sidebar. Non serve uscire dall'app per gestire il versionamento.
Operazioni supportate
Stage, unstage, commit, diff, pull, push, stash, branch — tutte le operazioni git fondamentali sono disponibili dalla UI. Il Git Explorer mostra l'albero dei file con lo stato in tempo reale.
AI Commit & Branch
Il sistema analizza i file staged, il contesto della sessione e il task collegato per generare commit message in formato Conventional Commits. I branch name vengono generati automaticamente dal contesto del task.
Diff Viewer
Visualizza le differenze tra file e commit con syntax highlighting. Confronta versioni side-by-side direttamente dalla sessione.
Risoluzione conflitti
In caso di conflitti merge, l'AI assiste nella risoluzione suggerendo la soluzione piu appropriata basata sul contesto del progetto.
Database Explorer
Il Database Explorer rileva automaticamente la connessione dal progetto e consente di navigare i dati in modalita read-only.
Connessione automatica
PromptOps analizza il progetto cercando file di configurazione e rileva automaticamente la connessione database. Supporta i principali database relazionali.
Navigazione dati
Esplora tabelle, filtra e ordina i dati, ispeziona lo schema. Tutte le operazioni sono in read-only per sicurezza — non puoi modificare i dati accidentalmente.
Schema Inspector
Visualizza la struttura delle tabelle: colonne, tipi, chiavi primarie e relazioni. Utile per dare contesto all'agente AI quando lavora con il database.
Voice Control
Invia comandi vocali all'agente AI senza toccare la tastiera.
Come funziona
Premi il pulsante microfono (o la shortcut dedicata) e parla. Il sistema di speech-to-text nativo di macOS trascrive il tuo comando in un prompt che viene inviato all'agente. Attualmente disponibile solo su macOS.
Suggerimenti
Parla in modo chiaro e conciso. Il sistema funziona meglio con istruzioni dirette. Puoi dettare prompt complessi — la trascrizione gestisce punteggiatura e formattazione.
Team e Collaborazione
PromptOps Manager supporta la collaborazione a livello di team con ruoli, permessi e condivisione strutturata.
Creare un team
Crea un team dal pannello Team. Invita membri via email — l'invito ha uno stato tracciato (pending, accepted, declined). Ogni membro ha un ruolo: owner, admin o member.
Ruoli e permessi
Owner: controllo completo, gestione membri e impostazioni. Admin: gestione sessioni, prompt e documenti. Member: accesso ai prompt condivisi e alle sessioni del team.
Condivisione
Prompt, sessioni e documenti possono essere condivisi a livello di team. Il team lead vede tutte le cronologie e i workflow di sviluppo dell'organizzazione.
Documenti e note
Crea note contestuali e documenti collegati a sessioni, file o task. I documenti sono tipizzati per categoria con ricerca full-text e riutilizzabili cross-progetto.
Token Efficiency Engine
Il sistema di ottimizzazione dei token riduce il consumo e traccia il risparmio in tempo reale.
Smart Context Injection
All'avvio della sessione, viene iniettata una mappa del progetto (struttura, entry point, file recenti). L'agente sa subito dove andare — niente esplorazione alla cieca. Risparmio: 30K-100K token per sessione.
Sub-Agent Prompt Optimization
I prompt dei sub-agent vengono arricchiti con i file realmente modificati (da git diff) e istruzioni di scope ridotto. L'agente legge 5 file mirati invece di esplorarne 30. Risparmio: 50K-70K token per sub-agent.
File Read Cache
Tracking di ogni file letto con hash MD5 del contenuto. I re-read ridondanti (file invariati) vengono rilevati e segnalati.
Dashboard
Nella dashboard: totale token usati, token risparmiati, efficienza media e classifica sessioni per risparmio. Dati aggregati da tutte le sessioni con persistenza su database.
Optimization Flags
Ogni sessione mostra quali ottimizzazioni sono attive (Smart Context, Cache, Graph, Tool Filtering, Local Execution) con spiegazione di come ciascuna contribuisce al risparmio.
Docker e Integrazioni
PromptOps si integra con Docker e altri strumenti del tuo stack di sviluppo.
Docker Status
Monitora i container Docker del progetto direttamente dall'app. Vedi stato e metadata senza cambiare contesto. Il monitoraggio e integrato nel pannello workspace.
Hook e automazioni
Configura hook su eventi della sessione: on_start, on_prompt, on_commit, on_end. Ogni hook esegue un comando shell. Le pipeline sono condivisibili a livello team.
Code Editor
Apri, modifica e salva file senza uscire dalla sessione. Editor integrato con syntax highlighting e rilevamento automatico del linguaggio.
Progetti e Workspace
I workspace collegano le directory locali ai progetti remoti, mantenendo la coerenza su piu device.
Workspace
Ogni workspace associa una directory locale a un workspace remoto. Il sistema usa l'hardware ID del device per la sincronizzazione — puoi lavorare sullo stesso progetto da macchine diverse.
Progetti
I progetti raggruppano workspace, sessioni, prompt e documenti. Ogni progetto ha i suoi membri, ruoli e permessi. Le sessioni vengono automaticamente scoped al progetto attivo.
Sprint Board
Board Kanban integrata con sprint (start/end date, velocity tracking). I task seguono una state machine: backlog, in_progress, review, done. Relazione many-to-many tra task e sessioni per tracciare quali sessioni AI hanno lavorato su quale task.
Requisiti di sistema
Requisiti minimi per eseguire PromptOps Manager Desktop.
macOS: macOS 12 Monterey o successivo. Chip Intel o Apple Silicon. 4 GB RAM minimo.
Windows: Windows 10 (64-bit) o successivo. 4 GB RAM minimo.
Linux: Ubuntu 20.04+, Fedora 36+ o equivalente. 4 GB RAM minimo.
Per i provider AI: e necessario un account attivo con il provider scelto (Anthropic, OpenAI, Google, GitHub).
Connessione internet necessaria per la comunicazione con i provider AI e la sincronizzazione con il backend.
