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 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 dev