명령어
Astreus CLI의 모든 명령어와 키보드 단축키에 대한 전체 레퍼런스입니다. 이 명령어를 사용해 에이전트 개발 세션을 관리하고, 모델을 전환하고, 워크플로우를 정리하세요.
Astreus CLI의 모든 명령어와 키보드 단축키에 대한 전체 레퍼런스입니다. 이 명령어를 사용해 에이전트 개발 세션을 관리하고, 모델을 전환하고, 워크플로우를 정리하세요.
슬래시 명령어
| 명령어 | 설명 |
|---|---|
/model [name] | AI 모델을 변경합니다 (이름을 지정하지 않으면 선택기가 열립니다) |
/provider [name] | AI 프로바이더를 변경합니다 (이름을 지정하지 않으면 선택기가 열립니다) |
/sessions | 세션 관리자를 엽니다 |
/new | 새 채팅 세션을 시작합니다 |
/attach <path> | 파일이나 폴더를 첨부합니다 |
/attachments | 현재 첨부 항목을 표시합니다 |
/clear-attachments | 모든 첨부 항목을 지웁니다 |
/pwd | 현재 작업 디렉터리를 표시합니다 |
/tools | 등록된 도구를 표시합니다 |
/graph | 그래프/세션 상태를 표시합니다 |
/settings | 설정 패널을 엽니다 |
/clear | 채팅 기록을 지웁니다 |
/help | 사용 가능한 명령어를 표시합니다 |
/exit | CLI를 종료합니다 |
명령어 별칭
더 빠른 입력을 위해 다음 단축 표현을 사용할 수 있습니다:
| 별칭 | 전체 명령어 |
|---|---|
/session | /sessions |
/add 또는 /a | /attach |
/ca | /clear-attachments |
/status | /graph |
/quit 또는 /q | /exit |
키보드 단축키
| 단축키 | 동작 |
|---|---|
Ctrl+C | CLI 종료 |
Escape | 현재 작업 취소 |
↑/↓ | 명령어 기록 또는 제안 탐색 |
Tab | 명령어 자동완성 |
? | 명령어 단축키 표시 토글 |
내장 파일 도구
CLI는 에이전트 프로젝트를 관리하기 위한 강력한 파일 시스템 도구를 제공합니다. AI는 이 도구들을 사용해 에이전트, 플러그인, 설정을 만들고 코드를 수정합니다:
| 도구 | 설명 |
|---|---|
read_file | 파일의 내용을 읽습니다 |
write_file | 파일에 내용을 씁니다 (필요 시 디렉터리를 생성합니다) |
edit_file | 특정 내용을 교체하여 파일을 편집합니다 |
list_directory | 디렉터리의 내용을 나열합니다 |
create_directory | 새 디렉터리를 생성합니다 |
delete_file | 파일이나 디렉터리를 삭제합니다 |
move_file | 파일이나 디렉터리를 이동하거나 이름을 변경합니다 |
search_files | 이름 패턴으로 파일을 검색합니다 |
세션 관리
세션 보기
/sessions세션 관리자를 열어 다음을 할 수 있습니다:
- 저장된 모든 세션 보기
- 세션 간 전환
- 오래된 세션 삭제
- 세션 메타데이터 확인 (날짜, 메시지, 모델)
새 세션 시작
/new이전 세션을 유지하면서 새 세션을 만듭니다.
세션 자동 저장
모든 대화는 자동으로 저장됩니다. CLI를 다시 시작하면 이전에 멈춘 지점부터 이어갈 수 있습니다.
파일 첨부
파일 첨부하기
/attach ./src/index.ts대화 컨텍스트에 파일을 첨부합니다. AI는 이 파일을 읽고 참조할 수 있습니다.
폴더 첨부하기
/attach ./src폴더 전체를 첨부합니다. 폴더가 첨부되면 해당 폴더가 파일 작업의 작업 디렉터리가 됩니다.
드래그 앤 드롭
터미널에 파일 경로를 직접 드래그 앤 드롭할 수도 있습니다.
첨부 항목 보기
/attachments현재 첨부된 모든 파일과 폴더를 표시합니다.
첨부 항목 지우기
/clear-attachments또는 단축 명령어를 사용하세요:
/ca모델 전환
빠른 전환
/model gpt-4o지정한 모델로 즉시 전환합니다.
대화형 선택
/model현재 프로바이더에서 사용 가능한 모든 모델을 보여주는 대화형 모델 선택기를 엽니다.
프로바이더 변경
/provider claude다른 프로바이더로 전환합니다. 해당 프로바이더에 맞는 API 키가 설정되어 있어야 합니다.
예제 세션: 에이전트 구축하기
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예제 세션: 새 에이전트 스캐폴딩하기
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마지막 업데이트: 2026년 7월 6일
이 섹션에서