시작하기 · 빠른 시작

빠른 시작

처음 켠 순간부터 5분 안에 한 바퀴 — 첫 터미널, 셸 추가, 패널 분할, 파일 편집, 인앱 브라우저, 그리고 (옵션) 다른 AI를 워커로 부리는 오케스트레이션까지.

5분 안에 한 바퀴

설치는 다운로드 · 설치를 참고하세요. 앱이 떠 있다면 아래 단계를 순서대로 따라가며 핵심 화면을 만져봅니다.

1. 앱 실행 — 첫 터미널이 자동으로

   앱을 실행하면 별도 조작 없이 첫 터미널 탭이 자동으로 열립니다. 새 터미널은 탐색기의 활성 프로젝트 루트에서 시작합니다.

   orchterm — 첫 실행

   PowerShell

   # 앱을 켜면 첫 터미널이 자동으로 열립니다 (활성 프로젝트 루트에서 시작) PS D:\orch-term>

   ① 콜드 스타트 중 친 첫 키도 버퍼링되어 유실되지 않습니다. 더 보기 → 터미널.

2. 새 터미널 · 셸 선택 (＋)

   탭바의 ＋ 또는 패널 우상단 액션으로 새 터미널을 엽니다. 설치된 셸을 자동 감지해 드롭다운에 보여줍니다 — PowerShell · cmd · Git Bash · WSL 등.

   새 터미널 — 셸 선택

   새 터미널

   ⌷ PowerShell기본

   ⎇ Git Bash기본 설정

   ▮ cmd기본 설정

   🐧 Ubuntu (WSL)기본 설정

   ② 목록에 뜬 셸을 고르면 활성 패널의 새 탭으로 열립니다. 더 보기 → 터미널.

3. 패널 분할 — 화면 나누기

   패널 우상단의 분할 액션으로 화면을 나눕니다 — 아래로, 오른쪽. 각 패널은 독립된 셸이고, Ctrl+Alt+방향키로 인접 패널을 오갑니다.

   orchterm — 패널 2개 (오른쪽 분할)

   PowerShell

   PS D:\orch-term> npm run dev ➜ Local: http://localhost:5181/ PS D:\orch-term>

   Git Bash

   user@pc:~/orch-term$ git status On branch main nothing to commit, working tree clean

   ③ 활성 패널은 액센트 테두리로 강조됩니다. 더 보기 → 탭 · 패널.

4. 파일 더블클릭 → 에디터 탭

   탐색기에서 파일을 더블클릭하면 활성 패널에 에디터 탭으로 열립니다(단일 클릭은 미리보기). 외부 변경 자동 리로드 · 인코딩 표시 · Ctrl+F 찾기를 지원합니다.

   orchterm — 에디터

   PowerShell

   terminal.ts

   1import { invoke } from "@tauri-apps/api/core";

   2

   3// 새 터미널을 활성 프로젝트 루트에서 연다

   4export async function openTerminal(cwd?: string) {

   5 return invoke("pty_spawn", { cwd });

   6}

   terminal.ts UTF-8

   ④ 로드한 인코딩은 하단 상태바 우측에 표시됩니다(에디터 탭일 때만). 더 보기 → 코드 에디터.

5. 주소 입력 → 인앱 브라우저 탭

   주소창에 URL을 입력하면 인앱 브라우저 탭으로 엽니다. https면 자물쇠가 뜨고, 버튼으로 시스템 브라우저에서 엽니다. 로컬 파일도 바로 봅니다.

   orchterm — 인앱 브라우저

   Orch term 가이드

   ‹›

   github.com/zendy00/orch-term-pages

   Orch term · 문서

   주소창에 친 URL이 이 자식 웹뷰 탭으로 열렸습니다.

   ⑤ https면 자물쇠 · 새 창 링크는 제자리 이동으로 가로챕니다. 더 보기 → 인앱 브라우저.

6. (옵션) 오케스트레이션 — 워커 부르기

   설정에서 오케스트레이션을 켜면(기본 꺼짐), 지휘자(claude) 탭에서 자연어로 다른 AI(codex · agy · claude)를 워커로 띄워 다중 턴으로 협업시킬 수 있습니다.

   commander · claudeorchestrating

   commander · claude

   backend · codex

   ❯ backend(codex)에게 SSH 터널 모듈 리뷰를 맡겨줘 ▸ open_session codex from=ep_claude_8f3a… → { session_id: s_4c1e } ▸ send "channel_open_direct_tcpip 동시성 안전한지 봐줘" ⟳ codex 작업 중… (출력 idle 대기) ◂ reply codex: "&self 차용이라 동시성 안전. 리스너 127.0.0.1 바인드 확인." ❯

   ⑥ 워커를 열고 → 지시하고 → 응답을 받는 한 사이클. 더 보기 → 에이전트 오케스트레이션.

   켜려면 재시작이 필요하고(127.0.0.1 전용), 앱 안 에이전트 협업이 필요 없으면 이 단계는 건너뛰어도 됩니다.

다음엔 어디로

한 바퀴를 돌았다면, 각 기능의 디테일은 아래에서 이어집니다.

알아두면 좋은 단축키