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#

ComandoDescrizione
/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)
/sessionsApre il gestore delle sessioni
/newAvvia una nuova sessione di chat
/attach <path>Allega un file o una cartella
/attachmentsMostra gli allegati correnti
/clear-attachmentsRimuove tutti gli allegati
/pwdMostra la directory di lavoro corrente
/toolsMostra i tool registrati
/graphMostra lo stato del grafo/della sessione
/settingsApre il pannello delle impostazioni
/clearCancella la cronologia della chat
/helpMostra i comandi disponibili
/exitEsce dalla CLI

Alias dei comandi#

Per scrivere più velocemente, puoi usare queste scorciatoie:

AliasComando completo
/session/sessions
/add o /a/attach
/ca/clear-attachments
/status/graph
/quit o /q/exit

Scorciatoie da tastiera#

ScorciatoiaAzione
Ctrl+CEsce dalla CLI
EscapeAnnulla l'operazione corrente
↑/↓Naviga la cronologia dei comandi o i suggerimenti
TabCompletamento 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:

ToolDescrizione
read_fileLegge il contenuto di un file
write_fileScrive contenuto in un file (crea le directory se necessario)
edit_fileModifica un file sostituendo un contenuto specifico
list_directoryElenca il contenuto di una directory
create_directoryCrea una nuova directory
delete_fileElimina un file o una directory
move_fileSposta o rinomina un file o una directory
search_filesCerca file in base a un pattern di nome

Gestione delle sessioni#

Visualizzare le sessioni#

text
/sessions

Apre 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#

text
/new

Crea 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#

text
/attach ./src/index.ts

Allega un file al contesto della conversazione. L'AI può leggere e fare riferimento a questo file.

Allegare una cartella#

text
/attach ./src

Allega 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#

text
/attachments

Mostra tutti i file e le cartelle attualmente allegati.

Rimuovere gli allegati#

text
/clear-attachments

Oppure usa la scorciatoia:

text
/ca

Cambio del modello#

Cambio rapido#

text
/model gpt-4o

Passa immediatamente al modello specificato.

Selezione interattiva#

text
/model

Apre un selettore interattivo di modelli con tutti i modelli disponibili per il provider corrente.

Cambiare provider#

text
/provider claude

Passa a un provider diverso. Sarà necessaria la chiave API appropriata configurata.

Esempio di sessione: costruire un agente#

text
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 configuration

Esempio di sessione: scaffolding di un nuovo agente#

text
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