> For the complete documentation index, see [llms.txt](https://orbitron.gitbook.io/orbitron-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbitron.gitbook.io/orbitron-docs/documentation/ko/user-guide/slash-commands-shortcut.md).

# 명령어 및 단축키 가이드

## 요약

| 🧩 명령어              | 🔤 간단 설명                    | ⌨️ 단축키                   |
| ------------------- | --------------------------- | ------------------------ |
| `/new`              | 새 세션 시작                     | `Ctrl + N`               |
| `/session`          | 세션 간 전환                     | `Ctrl + S`               |
| `/compact`          | 수동으로 세션 컨텍스트 압축             | —                        |
| `/export`           | 현재 세션을 텍스트 또는 마크다운 파일로 내보내기 | —                        |
| `/login`            | 로그인/인증 다이얼로그 열기             | `Ctrl + A`               |
| `/model`            | 모델 선택 다이얼로그 열기              | `Ctrl + O`               |
| `/context`          | 제목으로 컨텍스트 검색                | —                        |
| `/context:tag`      | 태그로 컨텍스트 검색                 | —                        |
| `/context:category` | 카테고리로 컨텍스트 검색               | —                        |
| `/theme`            | 터미널 테마 전환                   | `Ctrl + T`               |
| `/info`             | 사용자 정보 다이얼로그 열기             | —                        |
| `/log`              | 로그 보기                       | `Ctrl + L`               |
| `/hooks`            | Shell 훅 관리 (도구 실행 전후 자동화)   | —                        |
| `/mcp`              | MCP 서버 관리                   | `Ctrl + M`               |
| `/shared-mcps`      | 조직 공유 MCP 설정 조회 및 다운로드      | —                        |
| `/docs`             | Orbitron 공식 문서를 브라우저에서 열기   | —                        |
| `/update`           | Orbitron을 최신 버전으로 업데이트      | —                        |
| `!`                 | 대화형 Bash 모드 진입              | —                        |
| `/help`             | 도움말 메뉴 표시                   | `Ctrl + H` (Windows: F1) |
| `/quit`             | 애플리케이션 종료                   | `Ctrl + C`               |

#### 🧠 참고사항

* 슬래시 명령어는 프롬프트에서 입력하여 내부 작업을 빠르게 트리거할 수 있습니다.
* 명령어를 입력하는 동안 `Tab`을 눌러 자동 완성할 수 있습니다.

***

## 상세 가이드

### 기본 명령어

#### /help - 사용 가능한 모든 명령어를 확인할 수 있습니다.

사용법 :

```
/help
```

<figure><img src="/files/pyTOxUx5yJG93zD7dEfz" alt=""><figcaption></figcaption></figure>

활용 방법 :

* 처음 오비트론을 사용하는 경우
* 특정 기능의 사용법을 잊어버린 경우
* 새로운 기능이 추가되었는지 확인하고 싶은 경우

### 세션 관리

#### /session - 기존 세션 목록을 조회하고 특정 세션으로 이동할 수 있습니다.

사용법 :

```
/session
```

활용 방법 :

* 이전에 진행하던 작업을 이어서 수행하고 싶을 떄
* 여러 프로젝트를 동시에 관리하는 경우
* 특정 시점의 대화 내용을 다시 참조해야 할 때

#### /new - 새로운 대화 세션을 시작합니다.

사용법 :

```
/new
```

활용 방법 :

* 이전 작업과 완전히 분리된 새로운 프로젝트를 시작할 때
* 컨텍스트를 초기화하고 깨끗한 상태로 시작하고 싶을 때
* 다른 주제의 작업으로 전환할 때

#### /compact - 수동으로 세션의 컨텍스트를 압축합니다.

사용법 :

```
/compact
```

활용 방법 :

* 긴 대화로 인해 성능이 저하될 때
* 메모리 사용량을 최적화하고 싶을 때
* 중요한 정보만 남기고 불필요한 내용을 정리할 때

#### /export - 현재 세션의 대화 내용을 텍스트 또는 마크다운 파일로 내보냅니다.

사용법 :

```
/export
```

활용 방법 :

* 대화 내용을 백업하고 싶을 때
* 작업 내용을 팀과 공유해야 할 때
* 나중에 참조할 수 있도록 대화 기록을 보관하고 싶을 때
* 대화 내용을 다른 도구나 시스템에서 활용하고 싶을 때

저장 위치:

* 현재 작업 디렉토리의 `exports/` 폴더에 저장됨
* 파일 형식: `.txt`, `.md`, `.json` 중 선택 가능
* 파일명 형식: `export_YYYYMMDDHHMM.txt`, `export_YYYYMMDDHHMM.md`, `export_YYYYMMDDHHMM.json`
  * 동일한 파일명이 이미 존재하는 경우 초(SS)가 추가됨: `export_YYYYMMDDHHMMSS.txt/md/json`
* 빈 메시지와 도구 메시지는 자동으로 제외됨

### 인증 및 API 관리

#### /login - 로그인/인증 다이얼로그를 열어 오비트론에 로그인할 수 있습니다.

사용법 :

```
/login
```

활용 방법 :

* 다른 계정으로 전환하고 싶을 때
* 세션이 만료되어 재로그인이 필요할 때

{% hint style="info" %}
처음 사용하는 사용자는 **로그인 다이얼로그**가 자동으로 표시됩니다.
{% endhint %}

### AI 모델 관리

#### /model - 사용 가능한 AI 모델 목록을 확인하고 작업에 적합한 모델을 선택할 수 있습니다.

사용법:

```
/model
```

활용 방법 :

* 복잡한 분석 작업에 더 강력한 모델이 필요한 경우
* 빠른 응답이 필요한 간단한 작업의 경우
* 비용 효율성을 고려하여 적절한 모델을 선택하고 싶을 때

{% hint style="info" %}
사용 가능한 모델 목록은 [지원되는 AI 모델](/orbitron-docs/documentation/ko/user-guide/supported-ai-models.md)을 확인해주세요.
{% endhint %}

### 컨텍스트 관리

#### /context - 조직에서 관리하는 컨텍스트를 제목으로 검색하고 현재 작업에 적용할 수 있습니다.

사용법 :

```
/context
```

#### /context:tag - 태그를 기준으로 컨텍스트를 검색할 수 있습니다.

사용법:

```
/context:tag
```

#### /context:category - 카테고리를 기준으로 컨텍스트를 검색할 수 있습니다.

사용법:

```
/context:category
```

주요 특징 :

* 개인 컨텍스트: 본인만 사용할 수 있는 개별 컨텍스트
* 조직 컨텍스트: 팀이나 회사 내에서 공유되는 컨텍스트
* 자동 저장: 선택된 컨텍스트는 `orbitron.md` 파일에 저장됨

활용 방법 :

* 특정 프로젝트의 표준 가이드라인을 적용해야 할 때
* 팀 차원의 일관된 작업 품질을 유지하고 싶을 때
* 복잡한 설정이나 규칙을 반복적으로 사용해야 할 때

### 시스템 및 환경 설정

#### /theme - 터미널 테마를 전환하여 작업 환경을 개인화할 수 있습니다.

사용법 :

```
/theme
```

활용 방법 :

* 작업 환경에 맞는 시각적 테마가 필요할 때
* 장시간 작업 시 눈의 피로를 줄이고 싶을 때
* 다른 사용자와 화면을 공유할 때 가독성을 높이고 싶을 때

#### /info - 현재 사용자의 계정 정보, 현재 모드, 작업 디렉토리(cwd), 설치된 오비트론 버전을 확인할 수 있습니다.

사용법:

```
/info
```

활용 방법 :

* 현재 작업 환경을 빠르게 파악하고 싶을 때
* 문제 해결을 위해 시스템 정보가 필요할 때
* 다른 사용자와 환경 정보를 공유해야 할 때
* 버전 호환성을 확인해야 할 때

#### /permission - 현재 권한 목록을 확인하고 관리할 수 있습니다.

사용법:

```
/permission
```

권한 관리 단축키:

* `ESC`: 권한 관리 창 닫기
* `d`: 선택한 권한 삭제
* `c`: 모든 권한 일괄 삭제

활용 방법:

* AI 모델의 접근 권한을 확인하고 싶을 때
* 특정 권한을 제거하거나 초기화할 때
* 보안 및 프라이버시 설정을 관리할 때

#### /log - 오비트론의 실행 로그를 확인하여 문제를 진단할 수 있습니다.

사용법 :

```
/log
```

활용 방법 :

* 오류 발생 시 원인을 파악하고 싶을 때
* 시스템 성능을 모니터링할 때
* 기술 지원을 요청할 때 로그 정보가 필요한 경우

#### /quit : 오비트론 애플리케이션을 안전하게 종료합니다.

사용법 :

```
/quit
```

### 고급 기능

#### /hooks - Shell 훅을 관리하여 AI 도구 실행 전후에 자동화 작업을 수행할 수 있습니다.

사용법:

```
/hooks
```

주요 기능:

* **preToolUse**: AI가 도구를 실행하기 전에 커스텀 명령어 실행 (실행 차단 가능)
* **postMessageUse**: AI가 응답을 완료한 후 커스텀 명령어 실행
* 특정 도구 또는 모든 도구(`*`)에 대해 훅 설정 가능
* 훅 추가, 편집, 삭제, 테스트, 활성화/비활성화 지원

활용 방법:

* 코드 변경 전 자동 백업
* AI가 코드를 수정한 후 자동으로 테스트 실행
* 특정 도구 사용 시 보안 검증
* 작업 로그 자동 기록

{% hint style="info" %}
자세한 사용법은 [Shell 훅 가이드](/orbitron-docs/documentation/ko/user-guide/hooks-guide.md)를 참고하세요.
{% endhint %}

### MCP 관리

#### /mcp - MCP 서버 목록을 확인하고 관리할 수 있습니다.

사용법:

```
/mcp
```

주요 기능:

* 로컬에 설정된 MCP 서버 목록 확인
* 서버 상태 확인 (ready, loading, failed, disabled)
* 서버 추가, 삭제, 활성화/비활성화

활용 방법:

* MCP 서버 연결 상태를 확인하고 싶을 때
* 새로운 MCP 서버를 추가하거나 기존 서버를 관리할 때

#### /shared-mcps - 조직에서 공유한 MCP 설정을 조회하고 다운로드할 수 있습니다.

사용법:

```
/shared-mcps
```

주요 기능:

* 조직에서 공유한 MCP 서버 설정 목록 조회
* 선택한 설정을 클립보드에 복사
* JSON 파일로 다운로드

활용 방법:

* 조직에서 표준화한 MCP 설정을 가져오고 싶을 때
* 팀 내에서 동일한 MCP 환경을 구성해야 할 때
* Orbitron Web에서 등록한 MCP 설정을 터미널에서 빠르게 적용하고 싶을 때

#### /docs - Orbitron 공식 문서를 브라우저에서 바로 열 수 있습니다.

사용법:

```
/docs
```

활용 방법:

* 공식 문서에 빠르게 접근하고 싶을 때
* 기능과 모범 사례를 학습하고 싶을 때
* 문제 해결과 레퍼런스 조회가 필요할 때
* 최신 기능을 확인하고 싶을 때

#### /update - Orbitron을 최신 버전으로 업데이트합니다.

사용법:

```
/update
```

주요 기능:

* 사용 가능한 최신 버전 확인
* 업데이트가 있으면 백그라운드에서 다운로드
* 다음 재시작 시 업데이트 적용
* 이미 최신 버전인 경우 현재 상태 표시

업데이트 프로세스:

1. **이미 최신 버전**: 최신 버전을 사용 중이면 "Already on the latest version" 표시
2. **이미 다운로드됨**: 이미 최신 버전 다운로드가 완료된 상태이면 "Update v{version} is already downloaded. Restart to apply." 표시
3. **다운로드 필요**: 백그라운드에서 업데이트 다운로드 중일 경우 "Downloading update v{version}..." 메시지 표시
4. **다운로드 완료**: 다운로드 성공 후 "Update completed: v{version}. Restart to use new version." 표시

활용 방법:

* 수동으로 업데이트 확인 및 설치
* 최신 기능과 버그 수정 사항 적용
* 중요한 보안 패치 받기

{% hint style="info" %}
자동 업데이트 설정에 대한 자세한 내용은 [자동 업데이트 가이드](/orbitron-docs/documentation/ko/user-guide/installation/auto-update.md)를 참고하세요.
{% endhint %}

#### ! (Bash 모드) - 대화형 Bash 명령어 실행 모드로 전환할 수 있습니다.

사용법:

```
!
```

주요 기능:

* 프롬프트에 `!`를 입력하여 Bash 모드 진입
* 비동기 명령 실행과 실시간 출력 표시
* `ESC` 키로 실행 중인 명령 즉시 취소
* Bash 명령어를 AI 컨텍스트와 분리하여 관리

활용 방법:

* 빠른 터미널 명령어 실행
* 긴 실행 시간이 필요한 작업 (빌드, 테스트 등)
* 여러 명령어를 순차적으로 실행

{% hint style="info" %}
자세한 사용법은 [Bash 모드 가이드](/orbitron-docs/documentation/ko/user-guide/bash-mode-guide.md)를 참고하세요.
{% endhint %}