Comandos

Referencia completa de todos los comandos de Astreus CLI y sus atajos de teclado. Usa estos comandos para gestionar tus sesiones de desarrollo de agentes, cambiar de modelo y organizar tu flujo de trabajo.

Comandos de barra#

ComandoDescripción
/model [name]Cambia el modelo de IA (abre el selector si no se indica un nombre)
/provider [name]Cambia el proveedor de IA (abre el selector si no se indica un nombre)
/sessionsAbre el gestor de sesiones
/newInicia una nueva sesión de chat
/attach <path>Adjunta un archivo o carpeta
/attachmentsMuestra los archivos adjuntos actuales
/clear-attachmentsElimina todos los archivos adjuntos
/pwdMuestra el directorio de trabajo actual
/toolsMuestra las herramientas registradas
/graphMuestra el estado del grafo/sesión
/settingsAbre el panel de ajustes
/clearBorra el historial del chat
/helpMuestra los comandos disponibles
/exitSale de la CLI

Alias de comandos#

Para escribir más rápido, puedes usar estos atajos:

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

Atajos de teclado#

AtajoAcción
Ctrl+CSalir de la CLI
EscapeCancelar la operación actual
↑/↓Navegar por el historial de comandos o las sugerencias
TabAutocompletar comando
?Mostrar/ocultar los atajos de comandos

Herramientas de archivos integradas#

La CLI ofrece potentes herramientas de sistema de archivos para gestionar tus proyectos de agentes. La IA las utiliza para crear agentes, plugins, configuraciones y modificar tu código:

HerramientaDescripción
read_fileLee el contenido de un archivo
write_fileEscribe contenido en un archivo (crea directorios si es necesario)
edit_fileEdita un archivo reemplazando contenido específico
list_directoryLista el contenido de un directorio
create_directoryCrea un nuevo directorio
delete_fileElimina un archivo o directorio
move_fileMueve o renombra un archivo o directorio
search_filesBusca archivos por patrón de nombre

Gestión de sesiones#

Ver sesiones#

text
/sessions

Abre el gestor de sesiones, donde puedes:

  • Ver todas las sesiones guardadas
  • Cambiar entre sesiones
  • Eliminar sesiones antiguas
  • Ver los metadatos de la sesión (fecha, mensajes, modelo)

Iniciar una nueva sesión#

text
/new

Crea una sesión nueva conservando la anterior.

Guardado automático de sesiones#

Todas las conversaciones se guardan automáticamente. Al reiniciar la CLI, puedes retomar donde lo dejaste.

Archivos adjuntos#

Adjuntar un archivo#

text
/attach ./src/index.ts

Adjunta un archivo al contexto de la conversación. La IA puede leerlo y hacer referencia a él.

Adjuntar una carpeta#

text
/attach ./src

Adjunta una carpeta completa. Cuando se adjunta una carpeta, esta se convierte en el directorio de trabajo para las operaciones de archivos.

Arrastrar y soltar#

También puedes arrastrar y soltar rutas de archivos directamente en la terminal.

Ver archivos adjuntos#

text
/attachments

Muestra todos los archivos y carpetas adjuntos actualmente.

Eliminar archivos adjuntos#

text
/clear-attachments

O usa el atajo:

text
/ca

Cambio de modelo#

Cambio rápido#

text
/model gpt-4o

Cambia inmediatamente al modelo especificado.

Selección interactiva#

text
/model

Abre un selector interactivo con todos los modelos disponibles para el proveedor actual.

Cambiar de proveedor#

text
/provider claude

Cambia a un proveedor distinto. Necesitarás tener configurada la clave de API correspondiente.

Ejemplo de sesión: construir 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

Ejemplo de sesión: crear un nuevo agente desde cero#

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