Comandos
Referência completa de todos os comandos e atalhos de teclado da Astreus CLI. Use estes comandos para gerenciar suas sessões de desenvolvimento de agentes,...
Referência completa de todos os comandos e atalhos de teclado da Astreus CLI. Use estes comandos para gerenciar suas sessões de desenvolvimento de agentes, trocar modelos e organizar seu fluxo de trabalho.
Comandos de Barra
| Comando | Descrição |
|---|---|
/model [name] | Muda o modelo de IA (abre o seletor se nenhum nome for informado) |
/provider [name] | Muda o provedor de IA (abre o seletor se nenhum nome for informado) |
/sessions | Abre o gerenciador de sessões |
/new | Inicia uma nova sessão de chat |
/attach <path> | Anexa um arquivo ou pasta |
/attachments | Mostra os anexos atuais |
/clear-attachments | Limpa todos os anexos |
/pwd | Mostra o diretório de trabalho atual |
/tools | Mostra as ferramentas registradas |
/graph | Mostra o estado do grafo/sessão |
/settings | Abre o painel de configurações |
/clear | Limpa o histórico do chat |
/help | Mostra os comandos disponíveis |
/exit | Sai da CLI |
Atalhos de Comando
Para digitar mais rápido, você pode usar estes atalhos:
| Atalho | Comando Completo |
|---|---|
/session | /sessions |
/add ou /a | /attach |
/ca | /clear-attachments |
/status | /graph |
/quit ou /q | /exit |
Atalhos de Teclado
| Atalho | Ação |
|---|---|
Ctrl+C | Sai da CLI |
Escape | Cancela a operação atual |
↑/↓ | Navega pelo histórico de comandos ou sugestões |
Tab | Autocompleta o comando |
? | Alterna a exibição dos atalhos de comando |
Ferramentas de Arquivo Nativas
A CLI fornece ferramentas poderosas de sistema de arquivos para gerenciar seus projetos de agentes. A IA as usa para criar agentes, plugins, configurações e modificar seu código:
| Ferramenta | Descrição |
|---|---|
read_file | Lê o conteúdo de um arquivo |
write_file | Escreve conteúdo em um arquivo (cria diretórios se necessário) |
edit_file | Edita um arquivo substituindo conteúdo específico |
list_directory | Lista o conteúdo de um diretório |
create_directory | Cria um novo diretório |
delete_file | Exclui um arquivo ou diretório |
move_file | Move ou renomeia um arquivo ou diretório |
search_files | Busca arquivos por padrão de nome |
Gerenciamento de Sessões
Ver Sessões
/sessionsAbre o gerenciador de sessões onde você pode:
- Ver todas as sessões salvas
- Alternar entre sessões
- Excluir sessões antigas
- Ver metadados da sessão (data, mensagens, modelo)
Iniciar Nova Sessão
/newCria uma sessão nova preservando a anterior.
Salvamento Automático de Sessão
Todas as conversas são salvas automaticamente. Ao reiniciar a CLI, você pode continuar de onde parou.
Anexos de Arquivo
Anexar um Arquivo
/attach ./src/index.tsAnexa um arquivo ao contexto da conversa. A IA pode ler e referenciar esse arquivo.
Anexar uma Pasta
/attach ./srcAnexa uma pasta inteira. Quando uma pasta é anexada, ela se torna o diretório de trabalho para as operações de arquivo.
Arrastar e Soltar
Você também pode arrastar e soltar caminhos de arquivo diretamente no terminal.
Ver Anexos
/attachmentsMostra todos os arquivos e pastas atualmente anexados.
Limpar Anexos
/clear-attachmentsOu use o atalho:
/caTroca de Modelo
Troca Rápida
/model gpt-4oMuda para o modelo especificado imediatamente.
Seleção Interativa
/modelAbre um seletor de modelo interativo com todos os modelos disponíveis para o provedor atual.
Trocar Provedor
/provider claudeMuda para um provedor diferente. Você precisará da chave de API apropriada configurada.
Exemplo de Sessão: Construindo um 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 configurationExemplo de Sessão: Montando um Novo 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Última atualização: 6 de julho de 2026
Nesta seção
Introdução
Assistente de desenvolvimento com IA para construir agentes com o framework Astreus. A CLI ajuda você a criar, testar e iterar em agentes de IA diretamente...
Configuração
Configure a Astreus CLI com variáveis de ambiente para total personalização. Essas configurações controlam tanto a própria CLI quanto os recursos...