Astreus

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,...

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

/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

/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

/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

/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

/attachments

Muestra todos los archivos y carpetas adjuntos actualmente.

Eliminar archivos adjuntos

/clear-attachments

O usa el atajo:

/ca

Cambio de modelo

Cambio rápido

/model gpt-4o

Cambia inmediatamente al modelo especificado.

Selección interactiva

/model

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

Cambiar de proveedor

/provider claude

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

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

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

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

Última actualización: 6 de julio de 2026