Orch term
기능 검색…Ctrl K

핵심 기능 · 탐색기

탐색기

좌측의 파일 탐색기. 여러 프로젝트 루트를 한 창에서 전환하고, 키보드만으로 트리를 누비며, 인라인 생성·이름변경·드래그&드롭으로 파일을 다룹니다.

멀티 프로젝트 전환

탐색기 헤더의 프로젝트 이름을 클릭하면 드롭다운이 열려 등록된 여러 프로젝트 루트 사이를 전환합니다. + 버튼으로 새 루트를 더합니다. 목록과 활성 루트는 저장되어 재시작 시 복원됩니다.

탐색기 패널 — 프로젝트 헤더·파일 검색바·파일 트리·하단 Git 브랜치
① 헤더의 프로젝트 이름을 클릭하면 드롭다운으로 등록된 루트를 전환합니다(+ 로 새 루트). ② 검색바는 하위 폴더까지 파일명 부분일치로 찾습니다.

키보드 네비게이션 · 멀티 셀렉트

마우스 없이 트리 전체를 다룹니다. 방향키로 항목을 오가고, 글자를 그냥 입력하면 이름이 일치하는 항목으로 점프합니다(타입어헤드). 여러 항목을 멀티 셀렉트해 한 번에 미리보기 탭으로 열 수 있습니다.

탐색기 — 멀티 셀렉트
orch-term
▾src
explorer.ts
explorer-filter.ts
explorer-git.ts
terminal.ts
▸docs
① 선택된 항목은 액센트 색으로 칠해집니다. ② 글자를 입력하면(exp…) 일치하는 이름으로 점프합니다.
키동작
↑ / ↓트리 항목 이동
Enter항목 선택 · 열기
Esc드롭다운 / 검색 닫기
글자 입력타입어헤드 — 일치하는 이름으로 점프

파일 검색 — 검색바에 입력하면 현재 폴더만이 아니라 하위 폴더 전체에서 파일명 부분일치로 찾습니다. node_modules·.git·target·dist 같은 무거운 폴더는 기본 제외됩니다.

인라인 생성 · 이름변경

선택한 위치에서 곧바로 파일·폴더를 만들고, 그 자리에서 이름을 바꿉니다. 생성 시 src/utils/new.ts처럼 중첩 경로를 한 번에 입력하면 빠진 폴더가 함께 만들어집니다.

새 파일 — 인라인 입력
orch-term
▾src
▾utils
platform.ts
① 입력 행에 utils/new.ts처럼 중첩 경로를 넣으면 빠진 폴더까지 만듭니다.

항목 위에서 이름변경을 시작하면 그 자리에서 편집합니다. 열려 있는 탭도 함께 동기화되어 이름변경·삭제가 그대로 반영됩니다.

이름변경 — 탭 동기화
explorer.ts → exp-tree.ts
// 탐색기에서 이름을 바꾸면 // 열린 에디터 탭 제목도 즉시 따라갑니다. export function buildTree() { … }
① 이름을 바꾸면 열린 탭 제목도 새 이름으로 따라갑니다(파일이 사라지면 탭도 정리).

드래그 & 드롭 — 경로 삽입

파일·폴더를 터미널 패널 위로 드롭하면 그 항목의 절대 경로가 커서 위치에 삽입되고, 드롭하는 동안 패널이 강조됩니다. "attach as context"로 끌면 같은 동작에 프로젝트 상대 경로를 넣습니다.

탐색기 → 터미널 드롭
orch-term
▾db
schema.sql
seed.sql
README.md
Git Bash
zendy@orch ~/orch-term $ sqlite3 orchterm.db < D:\orch-term\db\schema.sql
schema.sql
① 드롭하면 패널이 강조되고 절대 경로가 커서 위치에 삽입됩니다.

좌 · 우 배치 전환

탐색기 푸터의 / 버튼으로 탐색기를 화면 좌↔우로 옮깁니다. 위치는 저장되어 재시작 시 복원됩니다.

왼쪽 배치 (기본)
오른쪽 배치
푸터 — 배치 토글 · 브랜치 · 항목 수
…트리…
① 푸터에 활성 루트의 git 브랜치 + 항목 수. ② 버튼으로 좌/우 배치 토글.

접기/펴기는 상태바에 — 탐색기 열기/닫기는 헤더가 아니라 하단 상태바 좌측의 항상 보이는 버튼입니다. 접힘 여부와 폭은 Space별로 보존되어 재시작해도 복원됩니다.

빈 영역 우클릭 → 터미널 열기

탐색기의 폴더나 빈 영역을 우클릭하면 터미널에서 열기가 나타납니다. 폴더 위에서는 그 폴더에서, 빈 영역에서는 프로젝트 루트에서 새 터미널이 열립니다. 같은 메뉴에 잘라내기·복사·붙여넣기·복제, 탐색기에서 보기, 경로 복사, 모두 접기도 있습니다.

탐색기 빈 영역 우클릭 컨텍스트 메뉴 — 새 파일·새 폴더·터미널에서 열기·붙여넣기(비활성)·모두 접기
① 폴더 우클릭 = 그 폴더에서 · 빈 영역 우클릭 = 프로젝트 루트에서 새 터미널.

시스템 앱으로 열기 — 바이너리/비텍스트 파일은 OS 기본 앱으로 열리고, OS 탐색기에서 해당 파일이 선택된 채 열 수도 있습니다.

탐색기 · 파인더에서 orchterm으로 바로 열기

설치 후, Windows 탐색기와 macOS 파인더에서 파일·폴더를 우클릭하면 바로 orchterm으로 열 수 있습니다. 폴더를 열면 그 폴더를 이미 아는 Space가 있을 때는 그 Space로 전환하고, 없으면 폴더 이름으로 새 Space와 터미널을 만듭니다. 파일을 열면 그 파일을 담고 있는 프로젝트의 Space에서(없으면 지금 보던 Space에서) 에디터 탭으로 엽니다. 앱이 꺼져 있으면 실행하면서 열고, 이미 떠 있으면 새 창 없이 그 인스턴스에서 엽니다.

Windows와 macOS는 메뉴가 나오는 자리가 다릅니다. Windows 탐색기는 우클릭 메뉴에 orchterm으로 열기가 보입니다(파일·폴더·폴더 안 빈 공간 모두). Windows 11에서는 새 우클릭 메뉴 최상위가 아니라 추가 옵션 표시(또는 Shift+F10) 아래의 클래식 메뉴에 나옵니다 — Windows 10에서는 바로 최상위에 보입니다. macOS 파인더는 최상위 항목을 서드파티 앱이 만들 수 없어서(VS Code도 마찬가지입니다) 서브메뉴 두 곳을 씁니다 — 우클릭 다음으로 열기 ▸ orchterm, 그리고 서비스 ▸ orchterm에서 열기. 독 아이콘에 폴더를 끌어다 놓는 것도 됩니다.

macOS의 다음으로 열기 ▸에는 텍스트 계열 파일과 폴더만 orchterm이 나옵니다. macOS가 확장자를 텍스트로 분류하지 않는 파일 — 대표적으로 .ts(macOS는 영상 파일로 분류합니다), 확장자가 없는 파일(LICENSE·Dockerfile·.gitignore 등) — 은 목록에 나타나지 않습니다. macOS 쪽 제약이라 모든 에디터가 같습니다. 그런 파일은 서비스 ▸ orchterm에서 열기(모든 파일·폴더를 받습니다), 다음으로 열기 ▸ 기타…, 또는 독 아이콘 드롭으로 열면 됩니다.
우클릭 메뉴 — Windows / macOS
Windows — 우클릭 메뉴 (Win11은 추가 옵션 표시 아래)
연결 프로그램
orchterm으로 열기
속성
macOS — 서브메뉴
다음으로 열기 ▸
orchterm
서비스 ▸
orchterm에서 열기
① Windows 10은 우클릭하자마자 바로 보이고, Windows 11은 추가 옵션 표시를 먼저 펴야 합니다. ② macOS는 서브메뉴를 펴야 보입니다.

이 메뉴는 설치 프로그램이 등록합니다 — 설치 없이 실행한 빌드(포터블 실행 등)에는 나타나지 않습니다.