Documentazione / In questa pagina

Introduzione

Inizia con Talos, dal primo comando alla tua prima missione.

Talos è un harness per agenti di coding: usa modelli, strumenti e contesto per lavorare sui tuoi progetti. Questa guida ti accompagna nell’installazione e nella configurazione.

Vascend Talos

CLI · SDK · Epoch–Lease–Lens

Prima di iniziare

Apri un terminale su Windows, macOS o Linux. Ti serviranno un account Vascend e l’accesso a un provider di modelli. Le credenziali si configurano durante l’accesso.

Installa

Scegli il metodo adatto al tuo sistema. Gli installer ufficiali configurano Talos nel PATH e installano un runtime Node.js LTS verificato quando manca.

curl -fsSL https://vascend.it/install | bash

Gli script installano anche Node.js se necessario. Con npm, Bun, pnpm o Yarn serve un runtime compatibile; npm richiede Node.js 20 o superiore.

Al termine, apri un nuovo terminale se richiesto dall’installer ed esegui:

talos

Talos, anche dentro Horizon.

Talos è disponibile anche dentro Horizon, l’ambiente desktop di Vascend. Puoi lavorare con l’agente dall’interfaccia di Horizon oppure installare la CLI per usarlo direttamente nel terminale.

Scopri Horizon

Configura

Segui i due passaggi mostrati da Talos. Conferma il codice sul sito Vascend, poi collega il provider e seleziona il modello. Puoi annullare l’accesso con Esc o Ctrl+C.

/login
/models

Prima missione

Entra nella cartella del progetto, avvia Talos e descrivi un risultato concreto. Aggiungi vincoli e indica come verificare il lavoro.

cd my-project
talos
Trova la causa dei test che falliscono, correggila e verifica il risultato. Mantieni compatibile l’API pubblica.

Gestisci il contesto

L’epoch conserva l’obiettivo attivo e i vincoli della missione. Le lease limitano nel tempo il focus secondario. Le lens selezionano le informazioni utili. Ispeziona il contesto durante il lavoro:

/context explain
Epoch
L’obiettivo attivo mantiene la direzione del lavoro anche quando aggiungi chiarimenti.
Lease
Le lease separano l’attenzione temporanea dalle istruzioni che devono durare.
Lens
Con /context explain puoi osservare come viene composto il contesto.

Aggiornamenti

Quando pubblichiamo una nuova versione ufficiale, Talos propone l’aggiornamento all’avvio. Il prompt mostra versione attuale → nuova versione e ti lascia scegliere. Le release vengono verificate tramite firma npm e integrità SHA-512.

Leggi il changelog

Personalizza

Definisci le regole del progetto in AGENTS.md e adatta Talos con skill, strumenti MCP, estensioni e SDK. Inizia con una missione piccola e controlla i permessi prima di operare sui file.