Cli | The .NET Blog

dotnet new WinUI: Crea app Windows senza toccare Visual Studio

Emiliano Montesdeoca — Wed, 27 May 2026 00:00:00 +0000

Lo sviluppo WinUI richiedeva Visual Studio. Questo sta cambiando: Microsoft ha pubblicato template open source di progetti ed elementi per WinUI che funzionano con dotnet new, portando lo sviluppo di app Windows nel workflow standard della CLI.

Iniziare in tre comandi

# Installare i template
dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates

# Creare un'app NavigationView
dotnet new winui-navview -n MyApp

# Eseguirla
cd MyApp
dotnet run

Nessun Visual Studio, nessuna configurazione manuale del progetto. L’app si esegue con dotnet run.

Cosa è incluso

Template vuoto (dotnet new winui) — un punto di partenza moderno con una barra del titolo Fluent già configurata, icona app predefinita aggiornata con asset .ico, e corrette impostazioni predefinite per la modalità chiara/scura. Meglio del vecchio template vuoto che ti lasciava a configurare le basi da solo.

Template NavigationView (dotnet new winui-navview) — il pattern di navigazione master-detail, completamente configurato con un NavigationView, barra del titolo moderna e struttura di navigazione multipagina. Segue la siluetta standard delle app Windows per applicazioni basate sulla navigazione. Se stai costruendo qualcosa con navigazione laterale, inizia da qui.

Entrambi i template seguono le siluette delle app Windows — moderni pattern Fluent Design per layout, navigazione e struttura visiva — già pronti all’uso.

Perché è importante per gli sviluppatori che non usano Visual Studio

Gli sviluppatori WinUI che usano VS Code, Rider o strumenti da riga di comando sono stati penalizzati. I template Visual Studio esistenti non erano utilizzabili fuori da VS — bisognava ricreare manualmente la struttura del progetto e configurare le basi.

Questi template sono open source (vedi WindowsAppSDK PR #6407), sviluppati dai feedback della community, e disponibili ora. Il supporto Visual Studio è in corso — questi stessi template funzioneranno anche lì eventualmente.

Per i team che vogliono automatizzare la configurazione dei progetti WinUI, integrarla nella CI, o semplicemente usare un editor diverso da Visual Studio, questo è un miglioramento significativo.

Post originale: Introducing dotnet new WinUI templates

Cosmos DB Shell È in Anteprima Pubblica — E Ha un Server MCP Integrato

Emiliano Montesdeoca — Sun, 24 May 2026 00:00:00 +0000

Se hai mai dovuto saltare tra una scheda del portale, un esempio di SDK e uno script a metà completato solo per rispondere a una domanda su Cosmos DB, conosci già la frizione che questo progetto è progettato per eliminare.

Azure Cosmos DB Shell è appena entrato in anteprima pubblica. È una CLI open source con sintassi simile a bash e — la parte che lo rende interessante — un server MCP integrato.

Cosa lo Rende Diverso dalle Altre CLI di Database

La CLI in sé è utile: comandi familiari, supporto agli script, integrazione CI/CD. Quella parte è il minimo atteso per uno strumento di database orientato agli sviluppatori.

La parte interessante è l’integrazione del server MCP. Ogni comando che la CLI espone diventa disponibile come strumento MCP che i tuoi agenti IA possono chiamare. Non c’è nessuno strato API personalizzato, nessun codice di integrazione da scrivere. Il tuo agente può:

Navigare nelle gerarchie di database con cd, ls, pwd
Eseguire query SQL con query e ottenere risultati strutturati
Creare e modificare elementi con create item, update, rm
Gestire database e container con mkdb, mkcon, rmdb, rmcon
Ispezionare il contesto corrente con endpoint, pwd

Il cambiamento fondamentale: il tuo agente non sta parlando con un’API di Cosmos DB — sta parlando con la stessa interfaccia shell che usi tu. I comandi sono deterministici, verificabili e open source in modo da poter ispezionare esattamente cosa sta succedendo.

La Base Open Source È Importante

Questo non è un servizio gestito a scatola nera. La shell è open source, il che significa:

I team di sicurezza possono verificare l’implementazione
I team di piattaforma possono fare fork e estenderla per i loro standard specifici
Gli sviluppatori possono contribuire miglioramenti che beneficiano tutti

Per i team aziendali che adottano strumenti IA, “possiamo vedere esattamente come funziona” è sempre meno un requisito opzionale. L’open source qui è un differenziatore significativo.

Tre Scenari Che Diventano Più Semplici

Analisi intelligente dei dati — connetti un agente alla shell, fai domande in linguaggio naturale, ottieni risultati di query strutturati. L’agente gestisce la costruzione della query; la shell gestisce l’esecuzione.

Gestione autonoma dei dati — i workflow che devono creare, aggiornare o rimuovere dati in Cosmos DB possono farlo attraverso gli strumenti MCP senza necessitare un’integrazione personalizzata.

Monitoraggio e avvisi in tempo reale — un agente può interrogare periodicamente i container, confrontare i risultati e segnalare anomalie tramite qualsiasi canale di notifica abbia senso.

L’interfaccia MCP rende questi scenari componibili con qualsiasi piattaforma IA che parla MCP — non solo gli strumenti Microsoft.

Per Iniziare

La shell è in anteprima pubblica. Installala, configura la tua connessione Cosmos DB e abilita il server MCP. Da lì, qualsiasi host agente compatibile con MCP può scoprire e utilizzare gli strumenti.

Post originale: Announcing the Public Preview of Azure Cosmos DB Shell: Open-Source Power Meets AI-Driven Database Automation

Windows App Dev CLI v0.3: F5 dal terminale e UI Automation per gli agenti

Emiliano Montesdeoca — Thu, 23 Apr 2026 00:00:00 +0000

Questo articolo è stato tradotto automaticamente. Per la versione originale, clicca qui.

L’esperienza F5 di Visual Studio è fantastica. Ma dover aprire VS solo per avviare e fare debug di un’app Windows pacchettizzata è eccessivo — che si tratti di una pipeline CI, di un workflow automatizzato o di un agente AI che esegue i test.

Windows App Development CLI v0.3 è appena uscita e lo affronta direttamente con due funzionalità principali: winapp run e winapp ui.

winapp run: F5 da qualsiasi posto

winapp run prende una cartella di app non pacchettizzata e un manifesto, e fa tutto ciò che VS fa nel debug launch: registra un pacchetto loose, avvia l’app e preserva il LocalState tra i re-deploy.

# Compila l'app, poi avviala come app pacchettizzata
winapp run ./bin/Debug

Funziona per WinUI, WPF, WinForms, Console, Avalonia e altro. Le modalità sono pensate per sviluppatori e workflow automatizzati:

--detach: Avvia e restituisce il controllo al terminale immediatamente. Perfetto per CI.
--unregister-on-exit: Pulisce il pacchetto registrato alla chiusura dell’app.
--debug-output: Cattura i messaggi OutputDebugString e le eccezioni in tempo reale.

Nuovo pacchetto NuGet: dotnet run per le app pacchettizzate

Per gli sviluppatori .NET c’è un nuovo pacchetto NuGet: Microsoft.Windows.SDK.BuildTools.WinApp. Dopo l’installazione, dotnet run gestisce tutto l’inner loop: build, preparare un pacchetto loose-layout, registrare su Windows e avviare — tutto in un unico step.

winapp init
# o
dotnet add package Microsoft.Windows.SDK.BuildTools.WinApp

winapp ui: UI Automation dalla riga di comando

Questa è la funzionalità che apre gli scenari agentici. winapp ui fornisce accesso completo UI Automation a qualsiasi app Windows in esecuzione — WPF, WinForms, Win32, Electron, WinUI3 — direttamente dal terminale.

Cosa si può fare:

Elencare tutte le finestre di primo livello
Navigare l’albero completo di UI Automation di una finestra
Cercare elementi per nome, tipo o ID di automazione
Cliccare, invocare e impostare valori
Fare screenshot
Attendere la comparsa di elementi — ideale per la sincronizzazione dei test

Combinare winapp ui con winapp run crea un workflow completo build → avvio → verifica dal terminale. Un agente può eseguire l’app, ispezionare lo stato dell’UI e validare il risultato.

Altre novità

winapp unregister: Rimuove un pacchetto sideloaded quando si è finito.
winapp manifest add-alias: Aggiunge un alias per avviare l’app per nome dal terminale.
Tab completion: Configura il completamento PowerShell con un singolo comando.

Come ottenerlo

winget install Microsoft.WinAppCli
# o
npm install -g @microsoft/winappcli

La CLI è in preview pubblica. Il repository su GitHub ha la documentazione completa e l’annuncio originale ha tutti i dettagli.

Smetti di sorvegliare il tuo terminale: la modalità detached di Aspire cambia il flusso di lavoro

Emiliano Montesdeoca — Fri, 17 Apr 2026 00:00:00 +0000

Questo post è stato tradotto automaticamente. Per la versione originale, clicca qui.

Ogni volta che esegui un AppHost di Aspire, il tuo terminale sparisce. Bloccato. Occupato finché non premi Ctrl+C. Devi eseguire un comando veloce? Apri un’altra scheda. Vuoi controllare i log? Un’altra scheda. È una piccola frizione che si accumula in fretta.

Aspire 13.2 risolve questo problema. James Newton-King ha scritto tutti i dettagli, e onestamente, questa è una di quelle funzionalità che cambia immediatamente il modo in cui lavori.

Modalità detached: un comando, terminale recuperato

aspire start

Questa è la scorciatoia per aspire run --detach. Il tuo AppHost si avvia in background e riottieni il terminale immediatamente. Niente schede extra. Niente multiplexer di terminale. Solo il tuo prompt, pronto all’uso.

Gestire ciò che è in esecuzione

Il punto è questo — eseguire in background è utile solo se riesci a gestire ciò che c’è là fuori. Aspire 13.2 include un set completo di comandi CLI proprio per questo:

# List all running AppHosts
aspire ps

# Inspect the state of a specific AppHost
aspire describe

# Stream logs from a running AppHost
aspire logs

# Stop a specific AppHost
aspire stop

Questo trasforma il CLI di Aspire in un vero gestore di processi. Puoi avviare più AppHost, controllare il loro stato, seguire i loro log e spegnerli — tutto da un’unica sessione di terminale.

Combinalo con la modalità isolata

La modalità detached si abbina naturalmente con la modalità isolata. Vuoi eseguire due istanze dello stesso progetto in background senza conflitti di porta?

aspire start --isolated
aspire start --isolated

Ognuna ottiene porte casuali, secret separati e il proprio ciclo di vita. Usa aspire ps per vedere entrambe, aspire stop per fermare quella di cui non hai più bisogno.

Perché questo è enorme per gli agenti di codice

Qui diventa davvero interessante. Un agente di codice che lavora nel tuo terminale ora può:

Avviare l’app con aspire start
Interrogare il suo stato con aspire describe
Controllare i log con aspire logs per diagnosticare problemi
Fermarla con aspire stop quando ha finito

Tutto senza perdere la sessione del terminale. Prima della modalità detached, un agente che eseguiva il tuo AppHost si bloccava nel proprio terminale. Ora può avviare, osservare, iterare e ripulire — esattamente come vorresti che funzionasse un agente autonomo.

Il team di Aspire ha puntato su questo. Eseguire aspire agent init configura un file di skill di Aspire che insegna questi comandi agli agenti. Così strumenti come l’agente di codice di Copilot possono gestire i tuoi workload Aspire direttamente.

Per concludere

La modalità detached è un upgrade del flusso di lavoro mascherato da semplice flag. Smetti di cambiare contesto tra i terminali, gli agenti smettono di bloccarsi da soli, e i nuovi comandi CLI ti danno visibilità reale su ciò che è in esecuzione. È pratico, è pulito, e rende il ciclo di sviluppo quotidiano notevolmente più fluido.

Leggi il post completo per tutti i dettagli e scarica Aspire 13.2 con aspire update --self.

azd update — Un solo comando per tutti i tuoi package manager

Emiliano Montesdeoca — Wed, 15 Apr 2026 00:00:00 +0000

Questo post è stato tradotto automaticamente. Per la versione originale, clicca qui.

Conosci quel messaggio “È disponibile una nuova versione di azd” che compare ogni poche settimane? Quello che ignori perché non ricordi se hai installato azd tramite winget, Homebrew o quello script curl che hai eseguito sei mesi fa? Ecco, finalmente è stato risolto.

Microsoft ha appena rilasciato azd update — un unico comando che aggiorna Azure Developer CLI all’ultima versione indipendentemente da come lo hai installato in origine. Windows, macOS, Linux — non importa. Un solo comando.

Come funziona

azd update

Tutto qui. Se vuoi accesso anticipato alle nuove funzionalità, puoi passare alla build giornaliera insiders:

azd update --channel daily
azd update --channel stable

Il comando rileva il tuo metodo di installazione attuale e utilizza il meccanismo di aggiornamento appropriato dietro le quinte. Niente più “aspetta, ho usato winget o choco su questa macchina?”

Il piccolo dettaglio

azd update è disponibile a partire dalla versione 1.23.x. Se sei su una versione precedente, dovrai fare un ultimo aggiornamento manuale usando il tuo metodo di installazione originale. Dopo di che, azd update gestisce tutto d’ora in avanti.

Controlla la tua versione attuale con azd version. Se hai bisogno di un’installazione da zero, la documentazione di installazione fa al caso tuo.

Perché è importante

È un piccolo miglioramento della qualità della vita, ma per chi di noi usa azd quotidianamente per il deploy di agenti IA e app Aspire su Azure, essere aggiornati significa meno momenti “questo bug era già stato corretto nell’ultima versione”. Una cosa in meno a cui pensare.

Leggi l’annuncio completo e l’approfondimento di Jon Gallant per maggiori dettagli.

.NET Aspire 13.2 Vuole Essere il Migliore Amico del Tuo Agente IA

Emiliano Montesdeoca — Fri, 10 Apr 2026 00:00:00 +0000

Questo post è stato tradotto automaticamente. Per la versione originale, clicca qui.

Conosci quel momento in cui il tuo agente IA scrive del codice solido, ti entusiasmi, e poi tutto crolla quando prova a eseguire la cosa? Conflitti di porte, processi fantasma, variabili d’ambiente sbagliate — improvvisamente il tuo agente sta bruciando token per risolvere problemi di avvio invece di costruire funzionalità.

Il team di Aspire ha appena pubblicato un post molto ben pensato su esattamente questo problema, e la loro risposta è convincente: Aspire 13.2 è progettato non solo per gli umani, ma per gli agenti IA.

Il problema è reale

Gli agenti IA sono incredibili nello scrivere codice. Ma consegnare un’app full-stack funzionante richiede molto di più che generare file. Devi avviare i servizi nell’ordine giusto, gestire le porte, impostare le variabili d’ambiente, connettere i database e ottenere feedback quando qualcosa si rompe. Al momento, la maggior parte degli agenti gestisce tutto questo per tentativi — eseguendo comandi, leggendo output di errore, riprovando.

Aggiungiamo istruzioni Markdown, skill personalizzati e prompt per guidarli, ma sono imprevedibili, non possono essere compilati e costano token solo per essere parsati. Il team di Aspire ha centrato l’insight chiave: gli agenti hanno bisogno di compilatori e API strutturate, non di più Markdown.

Aspire come infrastruttura per agenti

Ecco cosa porta Aspire 13.2 al tavolo dello sviluppo agentico:

Tutto il tuo stack in codice tipizzato. L’AppHost definisce la tua topologia completa — API, frontend, database, cache — in TypeScript o C# compilabile:

import { createBuilder } from './.modules/aspire.js';

const builder = await createBuilder();

const postgres = await builder.addPostgres("pg").addDatabase("catalog");
const cache = await builder.addRedis("cache");

const api = await builder
 .addNodeApp("api", "./api", "src/index.ts")
 .withHttpEndpoint({ env: "PORT" })
 .withReference(postgres)
 .withReference(cache);

await builder
 .addViteApp("frontend", "./frontend")
 .withReference(api)
 .waitFor(api);

await builder.build().run();

Un agente può leggere questo per capire la topologia dell’app, aggiungere risorse, collegare connessioni e compilare per verificare. Il compilatore gli dice immediatamente se qualcosa è sbagliato. Niente congetture, niente tentativi con i file di configurazione.

Un solo comando per governarli tutti. Invece di far destreggiate gli agenti tra docker compose up, npm run dev e script di avvio database, tutto è semplicemente aspire start. Tutte le risorse si avviano nell’ordine giusto, sulle porte giuste, con la configurazione giusta. I processi a lunga durata non bloccano l’agente — Aspire li gestisce.

Modalità isolata per agenti paralleli. Con --isolated, ogni esecuzione di Aspire ottiene le proprie porte casuali e segreti utente separati. Hai più agenti che lavorano su git worktree? Non entreranno in collisione. Questo è enorme per strumenti come gli agenti in background di VS Code che creano ambienti paralleli.

Occhi da agente attraverso la telemetria. Qui diventa davvero potente. La CLI di Aspire espone dati OpenTelemetry completi durante lo sviluppo — tracce, metriche, log strutturati. Il tuo agente non sta solo leggendo l’output della console sperando per il meglio. Può tracciare una richiesta fallita tra i servizi, profilare endpoint lenti e individuare esattamente dove le cose si rompono. Questa è osservabilità di livello produzione nel ciclo di sviluppo.

L’analogia dei parabordi del bowling

Il team di Aspire usa un’ottima analogia: pensa ad Aspire come ai parabordi della pista da bowling per gli agenti IA. Se l’agente non è perfetto (e non lo sarà), i parabordi impediscono che tiri nel canale. La definizione dello stack previene la misconfigurazioni, il compilatore cattura gli errori, la CLI gestisce i processi e la telemetria fornisce il ciclo di feedback.

Combina questo con qualcosa come Playwright CLI, e il tuo agente può davvero usare la tua app — cliccando nei flussi, controllando il DOM, vedendo le cose rotte nella telemetria, sistemando il codice, riavviando e testando di nuovo. Costruire, eseguire, osservare, sistemare. Questo è il ciclo di sviluppo autonomo che stavamo inseguendo.

Per iniziare

Nuovo con Aspire? Installa la CLI da get.aspire.dev e segui la guida introduttiva.

Già usi Aspire? Esegui aspire update --self per ottenere la 13.2, poi punta il tuo agente di coding preferito al tuo repo. Potresti stupirti di quanto va più lontano con i guardrail di Aspire.

Per concludere

Aspire 13.2 non è più solo un framework per app distribuite — sta diventando infrastruttura essenziale per agenti. Definizioni di stack strutturate, avvio con un comando, esecuzioni parallele isolate e telemetria in tempo reale danno agli agenti IA esattamente ciò di cui hanno bisogno per passare dallo scrivere codice al consegnare app.

Leggi il post completo dal team di Aspire per tutti i dettagli e i video dimostrativi.

La Modalità Isolata di Aspire Risolve l'Incubo dei Conflitti di Porta per lo Sviluppo Parallelo

Emiliano Montesdeoca — Fri, 10 Apr 2026 00:00:00 +0000

Questo post è stato tradotto automaticamente. Per la versione originale, clicca qui.

Se hai mai provato a eseguire due istanze dello stesso progetto contemporaneamente, conosci il dolore. La porta 8080 è già in uso. La porta 17370 è occupata. Uccidi qualcosa, riavvia, destreggiati tra le variabili d’ambiente — è un killer della produttività.

Questo problema sta peggiorando, non migliorando. Gli agenti IA creano git worktree per lavorare in modo indipendente. Gli agenti in background avviano ambienti separati. Gli sviluppatori fanno checkout dello stesso repo due volte per i feature branch. Ognuno di questi scenari sbatte contro lo stesso muro: due istanze della stessa app che lottano per le stesse porte.

Aspire 13.2 risolve questo con un singolo flag. James Newton-King del team Aspire ha scritto tutti i dettagli, ed è una di quelle feature “perché non l’avevamo già?”

La soluzione: `--isolated`

aspire run --isolated

Questo è tutto. Ogni esecuzione ottiene:

Porte random — niente più collisioni tra istanze
Segreti utente isolati — connection string e chiavi API restano separate per istanza

Nessuna riassegnazione manuale delle porte. Nessun giocoleria con le variabili d’ambiente. Ogni esecuzione ottiene un ambiente pulito e privo di collisioni automaticamente.

Scenari reali dove questo brilla

Checkout multipli. Hai un feature branch in una directory e un bugfix in un’altra:

# Terminal 1
cd ~/projects/my-app-feature
aspire run --isolated

# Terminal 2
cd ~/projects/my-app-bugfix
aspire run --isolated

Entrambi girano senza conflitti. La dashboard mostra cosa sta girando e dove.

Agenti in background in VS Code. Quando l’agente in background di Copilot Chat crea un git worktree per lavorare sul tuo codice in modo indipendente, potrebbe aver bisogno di eseguire il tuo AppHost Aspire. Senza --isolated, c’è un conflitto di porte con il tuo worktree principale. Con esso, entrambe le istanze funzionano e basta.

Lo skill Aspire distribuito con aspire agent init istruisce automaticamente gli agenti a usare --isolated quando lavorano nei worktree. Quindi l’agente in background di Copilot dovrebbe gestire tutto nativamente.

Test di integrazione in parallelo allo sviluppo. Hai bisogno di eseguire test contro un AppHost live mentre continui a sviluppare funzionalità? La modalità isolata dà a ogni contesto le sue porte e la sua configurazione.

Come funziona sotto il cofano

Quando passi --isolated, la CLI genera un ID di istanza unico per l’esecuzione. Questo guida due comportamenti:

Randomizzazione delle porte — invece di legarsi a porte prevedibili definite nella configurazione del tuo AppHost, la modalità isolata sceglie porte casuali disponibili per tutto — la dashboard, gli endpoint dei servizi, tutto. Il service discovery si adatta automaticamente, così i servizi si trovano a vicenda indipendentemente da quali porte ottengono.
Isolamento dei segreti — ogni esecuzione isolata ottiene il proprio store di segreti utente, identificato dall’ID dell’istanza. Connection string e chiavi API di un’esecuzione non trapelano in un’altra.

Il tuo codice non ha bisogno di modifiche. Il service discovery di Aspire risolve gli endpoint a runtime, quindi tutto si connette correttamente indipendentemente dall’assegnazione delle porte.

Quando usarlo

Usa --isolated quando esegui più istanze dello stesso AppHost contemporaneamente — che si tratti di sviluppo parallelo, test automatizzati, agenti IA o git worktree. Per lo sviluppo a singola istanza dove preferisci porte prevedibili, il normale aspire run funziona ancora benissimo.

Per concludere

La modalità isolata è una piccola feature che risolve un problema reale e sempre più comune. Man mano che lo sviluppo assistito da IA ci spinge verso più workflow paralleli — agenti multipli, worktree multipli, contesti multipli — la capacità di semplicemente avviare un’altra istanza senza lottare per le porte è essenziale.

Leggi il post completo per tutti i dettagli tecnici e provalo con aspire update --self per ottenere la 13.2.

Aspire 13.2 include una CLI per la documentazione — e anche il tuo agente IA può usarla

Emiliano Montesdeoca — Sat, 04 Apr 2026 00:00:00 +0000

Questo post è stato tradotto automaticamente. Per la versione originale, clicca qui.

Conosci quel momento in cui sei immerso in un Aspire AppHost, stai collegando integrazioni, e devi controllare esattamente quali parametri si aspetta l’integrazione Redis? Fai alt-tab al browser, cerchi su aspire.dev, strizzi gli occhi sulla documentazione delle API, poi torni al tuo editor. Contesto perso. Flusso interrotto.

Aspire 13.2 ha appena rilasciato una soluzione per questo. La CLI aspire docs ti permette di cercare, esplorare e leggere la documentazione ufficiale di Aspire direttamente dal tuo terminale. E siccome è supportata da servizi riutilizzabili, gli agenti IA e le skill possono usare gli stessi comandi per consultare la documentazione invece di allucinare API che non esistono.

Il problema che questo risolve davvero

David Pine lo dice perfettamente nel post originale: gli agenti IA erano terribili nell’aiutare gli sviluppatori a costruire app con Aspire. Raccomandavano dotnet run invece di aspire run, facevano riferimento a learn.microsoft.com per docs che vivono su aspire.dev, suggerivano pacchetti NuGet obsoleti, e — il mio preferito — allucinavano API inesistenti.

Perché? Perché Aspire è stato specifico per .NET molto più a lungo di quanto sia stato poliglotta, e i LLM lavorano con dati di addestramento che precedono le ultime funzionalità. Quando dai a un agente IA la possibilità di consultare la documentazione attuale, smette di tirare a indovinare e inizia a essere utile.

Tre comandi, zero schede del browser

La CLI è di una semplicità rinfrescante:

Elencare tutta la documentazione

aspire docs list

Restituisce ogni pagina di documentazione disponibile su aspire.dev. Serve un output leggibile dalle macchine? Aggiungi --format Json.

Cercare un argomento

aspire docs search "redis"

Cerca sia nei titoli che nei contenuti con punteggio di rilevanza ponderato. Lo stesso motore di ricerca che alimenta internamente gli strumenti di documentazione. Ottieni risultati classificati con titoli, slug e punteggi di rilevanza.

Leggere una pagina intera (o solo una sezione)

aspire docs get redis-integration

Trasmette la pagina completa in markdown nel tuo terminale. Ti serve solo una sezione?

aspire docs get redis-integration --section "Add Redis resource"

Precisione chirurgica. Niente scrolling su 500 righe. Solo la parte che ti serve.

L’aspetto agente IA

Ecco dove diventa interessante per noi sviluppatori che costruiamo con strumenti IA. Gli stessi comandi aspire docs funzionano come strumenti per agenti IA — tramite skill, server MCP, o semplici wrapper CLI.

Invece di far inventare al tuo assistente IA delle API Aspire basate su dati di addestramento obsoleti, può chiamare aspire docs search "postgres", trovare la documentazione ufficiale dell’integrazione, leggere la pagina giusta, e darti l’approccio documentato. Documentazione in tempo reale e aggiornata — non quello che il modello ha memorizzato sei mesi fa.

L’architettura dietro tutto questo è intenzionale. Il team Aspire ha costruito servizi riutilizzabili (IDocsIndexService, IDocsSearchService, IDocsFetcher, IDocsCache) anziché un’integrazione una tantum. Questo significa che lo stesso motore di ricerca funziona per gli umani nel terminale, gli agenti IA nel tuo editor, e l’automazione nella tua pipeline CI.

Scenari reali

Consultazioni rapide nel terminale: Sei tre file in profondità e hai bisogno dei parametri di configurazione Redis. Due comandi, novanta secondi, di nuovo al lavoro:

aspire docs search "redis" --limit 1
aspire docs get redis-integration --section "Configuration"

Sviluppo assistito dall’IA: La tua skill di VS Code avvolge i comandi CLI. Chiedi “Aggiungi un database PostgreSQL al mio AppHost” e l’agente consulta i docs reali prima di rispondere. Nessuna allucinazione.

Validazione CI/CD: La tua pipeline valida le configurazioni AppHost contro la documentazione ufficiale in modo programmatico. L’output --format Json si collega in modo pulito a jq e altri strumenti.

Basi di conoscenza personalizzate: Stai costruendo i tuoi strumenti IA? Invia l’output JSON strutturato direttamente nella tua base di conoscenza:

aspire docs search "monitoring" --format Json | jq '[.[] | {slug, title, summary}]'

Niente web scraping. Niente chiavi API. Gli stessi dati strutturati usati internamente dagli strumenti di documentazione.

La documentazione è sempre aggiornata

Questa è la parte che apprezzo di più. La CLI non scarica uno snapshot — interroga aspire.dev con caching basato su ETag. Nel momento in cui la documentazione viene aggiornata, la tua CLI e qualsiasi skill costruita su di essa lo riflette. Niente copie obsolete, niente momenti “ma il wiki diceva…”.

Per concludere

aspire docs è una di quelle piccole funzionalità che risolve un problema reale in modo pulito. Gli umani ottengono accesso alla documentazione nativo nel terminale. Gli agenti IA ottengono un modo per smettere di indovinare e iniziare a fare riferimento a docs reali. E tutto è supportato dalla stessa fonte di verità.

Se stai costruendo con .NET Aspire e non hai ancora provato la CLI, esegui aspire docs search "il-tuo-argomento-qui" e vedi come ti sembra. Poi considera di integrare quei comandi nella skill IA o nella configurazione di automazione che stai usando — i tuoi agenti ti ringrazieranno.

Dai un’occhiata all’approfondimento di David Pine su come sono nati gli strumenti di documentazione, e al riferimento ufficiale della CLI per tutti i dettagli.

Cli | The .NET Blog

dotnet new WinUI: Crea app Windows senza toccare Visual Studio

Iniziare in tre comandi

Cosa è incluso

Perché è importante per gli sviluppatori che non usano Visual Studio

Cosmos DB Shell È in Anteprima Pubblica — E Ha un Server MCP Integrato

Cosa lo Rende Diverso dalle Altre CLI di Database

La Base Open Source È Importante

Tre Scenari Che Diventano Più Semplici

Per Iniziare

Windows App Dev CLI v0.3: F5 dal terminale e UI Automation per gli agenti

winapp run: F5 da qualsiasi posto

Nuovo pacchetto NuGet: dotnet run per le app pacchettizzate

winapp ui: UI Automation dalla riga di comando

Altre novità

Come ottenerlo

Smetti di sorvegliare il tuo terminale: la modalità detached di Aspire cambia il flusso di lavoro

Modalità detached: un comando, terminale recuperato

Gestire ciò che è in esecuzione

Combinalo con la modalità isolata

Perché questo è enorme per gli agenti di codice

Per concludere

azd update — Un solo comando per tutti i tuoi package manager

Come funziona

Il piccolo dettaglio

Perché è importante

.NET Aspire 13.2 Vuole Essere il Migliore Amico del Tuo Agente IA

Il problema è reale

Aspire come infrastruttura per agenti

L’analogia dei parabordi del bowling

Per iniziare

Per concludere

La Modalità Isolata di Aspire Risolve l'Incubo dei Conflitti di Porta per lo Sviluppo Parallelo

La soluzione: --isolated

Scenari reali dove questo brilla

Come funziona sotto il cofano

Quando usarlo

Per concludere

Aspire 13.2 include una CLI per la documentazione — e anche il tuo agente IA può usarla

Il problema che questo risolve davvero

Tre comandi, zero schede del browser

Elencare tutta la documentazione

Cercare un argomento

Leggere una pagina intera (o solo una sezione)

L’aspetto agente IA

Scenari reali

La documentazione è sempre aggiornata

Per concludere

La soluzione: `--isolated`