Comandi
Riferimento completo per tutti i comandi e le scorciatoie da tastiera di Astreus CLI. Usa questi comandi per gestire le sessioni di sviluppo dei tuoi...
Riferimento completo per tutti i comandi e le scorciatoie da tastiera di Astreus CLI. Usa questi comandi per gestire le sessioni di sviluppo dei tuoi agenti, cambiare modelli e organizzare il tuo workflow.
Comandi slash
| Comando | Descrizione |
|---|---|
/model [name] | Cambia il modello AI (apre il selettore se non viene indicato un nome) |
/provider [name] | Cambia il provider AI (apre il selettore se non viene indicato un nome) |
/sessions | Apre il gestore delle sessioni |
/new | Avvia una nuova sessione di chat |
/attach <path> | Allega un file o una cartella |
/attachments | Mostra gli allegati correnti |
/clear-attachments | Rimuove tutti gli allegati |
/pwd | Mostra la directory di lavoro corrente |
/tools | Mostra i tool registrati |
/graph | Mostra lo stato del grafo/della sessione |
/settings | Apre il pannello delle impostazioni |
/clear | Cancella la cronologia della chat |
/help | Mostra i comandi disponibili |
/exit | Esce dalla CLI |
Alias dei comandi
Per scrivere più velocemente, puoi usare queste scorciatoie:
| Alias | Comando completo |
|---|---|
/session | /sessions |
/add o /a | /attach |
/ca | /clear-attachments |
/status | /graph |
/quit o /q | /exit |
Scorciatoie da tastiera
| Scorciatoia | Azione |
|---|---|
Ctrl+C | Esce dalla CLI |
Escape | Annulla l'operazione corrente |
↑/↓ | Naviga la cronologia dei comandi o i suggerimenti |
Tab | Completamento automatico del comando |
? | Attiva/disattiva la visualizzazione delle scorciatoie dei comandi |
Tool per i file integrati
La CLI fornisce potenti tool per il file system utili a gestire i tuoi progetti di agenti. L'AI li usa per creare agenti, plugin, configurazioni e modificare il tuo codice:
| Tool | Descrizione |
|---|---|
read_file | Legge il contenuto di un file |
write_file | Scrive contenuto in un file (crea le directory se necessario) |
edit_file | Modifica un file sostituendo un contenuto specifico |
list_directory | Elenca il contenuto di una directory |
create_directory | Crea una nuova directory |
delete_file | Elimina un file o una directory |
move_file | Sposta o rinomina un file o una directory |
search_files | Cerca file in base a un pattern di nome |
Gestione delle sessioni
Visualizzare le sessioni
/sessionsApre il gestore delle sessioni dove puoi:
- Visualizzare tutte le sessioni salvate
- Passare da una sessione all'altra
- Eliminare le vecchie sessioni
- Vedere i metadati della sessione (data, messaggi, modello)
Avviare una nuova sessione
/newCrea una sessione nuova preservando quella precedente.
Salvataggio automatico delle sessioni
Tutte le conversazioni vengono salvate automaticamente. Quando riavvii la CLI, puoi riprendere da dove avevi interrotto.
Allegati dei file
Allegare un file
/attach ./src/index.tsAllega un file al contesto della conversazione. L'AI può leggere e fare riferimento a questo file.
Allegare una cartella
/attach ./srcAllega un'intera cartella. Quando una cartella viene allegata, diventa la directory di lavoro per le operazioni sui file.
Trascinamento (drag and drop)
Puoi anche trascinare direttamente i percorsi dei file nel terminale.
Visualizzare gli allegati
/attachmentsMostra tutti i file e le cartelle attualmente allegati.
Rimuovere gli allegati
/clear-attachmentsOppure usa la scorciatoia:
/caCambio del modello
Cambio rapido
/model gpt-4oPassa immediatamente al modello specificato.
Selezione interattiva
/modelApre un selettore interattivo di modelli con tutti i modelli disponibili per il provider corrente.
Cambiare provider
/provider claudePassa a un provider diverso. Sarà necessaria la chiave API appropriata configurata.
Esempio di sessione: costruire un agente
You: /attach ./my-agent
Attached folder: ./my-agent (working directory set)
You: What's the current agent configuration?
Astreus: Let me check the project structure.
[Tool: list_directory] Listing ./my-agent...
[Tool: read_file] Reading ./my-agent/src/agent.ts...
This is an Astreus agent project with:
- Agent configured with GPT-4o model
- Memory enabled for conversation persistence
- No knowledge base configured yet
- No custom plugins
You: Add a knowledge base and ingest our docs folder
Astreus: I'll add knowledge base support to your agent.
[Tool: edit_file] Updating ./my-agent/src/agent.ts...
[Tool: write_file] Creating ./my-agent/src/ingest-docs.ts...
Done! I've updated your agent with:
- Knowledge base enabled in agent config
- Created ingest-docs.ts script to load your documentation
- Run `npx ts-node src/ingest-docs.ts` to ingest docs
You: Create a plugin for fetching weather data
Astreus: I'll create a weather plugin for your agent.
[Tool: create_directory] Creating ./my-agent/src/plugins...
[Tool: write_file] Creating ./my-agent/src/plugins/weather.ts...
[Tool: edit_file] Updating ./my-agent/src/agent.ts to register plugin...
Done! Weather plugin created with:
- get_weather tool for current conditions
- get_forecast tool for 5-day forecast
- Proper TypeScript types and error handling
- Registered in your agent configurationEsempio di sessione: scaffolding di un nuovo agente
You: Create a code review agent that can analyze PRs
Astreus: I'll create a complete code review agent project.
[Tool: create_directory] Creating ./code-review-agent...
[Tool: write_file] Creating package.json...
[Tool: write_file] Creating tsconfig.json...
[Tool: write_file] Creating .env.example...
[Tool: write_file] Creating src/agent.ts...
[Tool: write_file] Creating src/index.ts...
[Tool: write_file] Creating src/plugins/github.ts...
Done! Code review agent created with:
- Claude model (better for code analysis)
- GitHub plugin for PR fetching
- Memory for tracking reviewed PRs
- System prompt optimized for code review
Run these commands to get started:
cd code-review-agent
npm install
cp .env.example .env # Add your API keys
npm run devUltimo aggiornamento: 6 luglio 2026
In questa sezione
Introduzione
Assistente di sviluppo basato su AI per costruire agenti con il framework Astreus. La CLI ti aiuta a creare, testare e iterare su agenti AI direttamente dal...
Configurazione
Configura Astreus CLI con variabili d'ambiente per una personalizzazione completa. Queste impostazioni controllano sia la CLI stessa sia le funzionalità del...