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#
| Comando | Descripció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) |
/sessions | Abre el gestor de sesiones |
/new | Inicia una nueva sesión de chat |
/attach <path> | Adjunta un archivo o carpeta |
/attachments | Muestra los archivos adjuntos actuales |
/clear-attachments | Elimina todos los archivos adjuntos |
/pwd | Muestra el directorio de trabajo actual |
/tools | Muestra las herramientas registradas |
/graph | Muestra el estado del grafo/sesión |
/settings | Abre el panel de ajustes |
/clear | Borra el historial del chat |
/help | Muestra los comandos disponibles |
/exit | Sale de la CLI |
Alias de comandos#
Para escribir más rápido, puedes usar estos atajos:
| Alias | Comando completo |
|---|---|
/session | /sessions |
/add o /a | /attach |
/ca | /clear-attachments |
/status | /graph |
/quit o /q | /exit |
Atajos de teclado#
| Atajo | Acción |
|---|---|
Ctrl+C | Salir de la CLI |
Escape | Cancelar la operación actual |
↑/↓ | Navegar por el historial de comandos o las sugerencias |
Tab | Autocompletar 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:
| Herramienta | Descripción |
|---|---|
read_file | Lee el contenido de un archivo |
write_file | Escribe contenido en un archivo (crea directorios si es necesario) |
edit_file | Edita un archivo reemplazando contenido específico |
list_directory | Lista el contenido de un directorio |
create_directory | Crea un nuevo directorio |
delete_file | Elimina un archivo o directorio |
move_file | Mueve o renombra un archivo o directorio |
search_files | Busca archivos por patrón de nombre |
Gestión de sesiones#
Ver sesiones#
/sessionsAbre 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#
/newCrea 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.tsAdjunta un archivo al contexto de la conversación. La IA puede leerlo y hacer referencia a él.
Adjuntar una carpeta#
/attach ./srcAdjunta 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#
/attachmentsMuestra todos los archivos y carpetas adjuntos actualmente.
Eliminar archivos adjuntos#
/clear-attachmentsO usa el atajo:
/caCambio de modelo#
Cambio rápido#
/model gpt-4oCambia inmediatamente al modelo especificado.
Selección interactiva#
/modelAbre un selector interactivo con todos los modelos disponibles para el proveedor actual.
Cambiar de proveedor#
/provider claudeCambia 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 configurationEjemplo 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