Chop

원하는 칸에 터미널을 추가하고, 나눠 쓰는 macOS 앱

빈 칸의 +로 시작하고,
탭·좌우·상하·격자로 작업에 맞게 펼칩니다.

주요 기능 · 레이아웃 · 시작하기 · 단축키 · 기여하기

_{실제 Chop 창을 오리지널 배경 위에 구성한 이미지 · 라이트 / 다크}

Chop은?

Chop은 여러 셸을 한 창에서 다루는 macOS 네이티브 터미널 앱입니다. Swift와 AppKit으로 만들고, Ghostty의 libghostty 엔진과 Metal 렌더러를 사용합니다.

처음 열면 2×2로 나눈 네 칸 중 터미널 1이 바로 실행됩니다. 나머지 칸은 중앙의 +를 누를 때 열립니다. 터미널을 더 추가하거나 배치를 바꾸면서 각 칸에서 작업을 이어갈 수 있습니다.

터미널과 파일 트리 사이의 세로 영역에 있는 + 또는 ⌘T로 계속 추가할 수 있습니다. 빈 칸을 순서대로 채운 뒤, 모두 차면 아래에 두 칸짜리 행을 추가하고 첫 칸을 엽니다. 다음 추가는 옆의 빈 칸을 채웁니다. 이 버튼은 스크롤하거나 파일 트리를 숨겨도 남습니다.

이름은 버기의 동강동강 열매에서 가져왔습니다. 하나의 창을 동강동강 나눠 여러 터미널로 쓰는 모습에서 출발했습니다.

주요 기능

기능	설명
GitHub 프로젝트 클론	오른쪽 추가 영역 하단에서 저장소를 클론하고, 새 창의 터미널과 파일 트리를 해당 폴더에서 엽니다.
웹사이트 미리보기	터미널 옆의 새 칸에서 로컬 페이지와 웹사이트를 열고, 배치를 바꿔도 입력 상태를 유지합니다.
로컬 서버 주소	각 터미널의 실행 중인 로컬 포트를 헤더에 표시하고 새 웹 칸으로 엽니다. 여러 개면 주소 목록을 제공합니다.
프로젝트별 윈도우	파일 메뉴나 Dock 메뉴에서 새 창을 엽니다. 프로젝트마다 셸·레이아웃·파일 트리를 따로 유지합니다.
최근 프로젝트와 작업 구성	최근 폴더를 다시 열거나, 이름 붙여 저장한 배치·작업 경로·웹 주소를 새 창에서 불러옵니다.
계속 터미널 추가	빈 칸 중앙의 + 또는 오른쪽 세로 영역의 +로 터미널을 엽니다. 네 칸을 채운 뒤에도 아래로 추가합니다.
네 가지 보기	상단 탭, 좌우, 상하, 격자로 전환하며 기존 터미널을 모두 유지합니다.
자유로운 배치	분할 경계를 드래그해 크기를 바꾸고, 편집 모드에서 칸을 끌어 자리를 바꿉니다.
한 칸에 집중	현재 칸을 크게 보거나 원래 배치로 돌아갑니다. 다른 셸의 작업은 계속됩니다.
라이트·다크 모드	상단의 달·해 아이콘으로 전환합니다. 터미널 색상도 함께 바뀌며 선택을 기억합니다.
오른쪽 파일 트리	경로 입력, macOS 폴더 선택기, 홈·다운로드·문서 바로가기로 폴더를 탐색합니다.
파일 이름 검색	현재 폴더와 하위 폴더에서 파일·폴더를 찾고, 같은 이름은 상대 경로로 구분합니다.
경로 드래그 입력	파일이나 폴더를 터미널에 놓으면 셸 인자로 인용한 경로를 입력합니다. Enter는 보내지 않습니다.
작업 공간 복원	배치·이름·경로·선택한 칸을 저장하고, 다음 실행 때 새 셸로 엽니다.

한글 입력, 텍스트 선택, 스크롤백, 복사·붙여넣기를 지원합니다. 실행 중인 작업을 닫을 때는 확인하며, 셸이 종료된 칸은 다시 +로 열 수 있습니다.

헤더의 이름이나 연필 아이콘을 누르면 터미널 이름을 바꿉니다. 상단 탭 보기에서는 탭을 우클릭해 **이름 바꾸기…**를 선택합니다. ⌘⇧R도 사용할 수 있으며 바꾼 이름은 다음 실행에도 유지됩니다.

레이아웃

상단 왼쪽의 네 아이콘으로 보기를 바꿉니다.

보기	배치
탭	모든 칸을 상단 탭으로 유지하고 선택한 터미널 하나를 크게 표시합니다.
좌우	열린 칸을 가로로 나란히 배치합니다.
상하	열린 칸을 세로로 쌓습니다.
격자	기본 2×2에서 두 열을 유지하며 아래로 늘어납니다.

터미널이 많아도 보기 전환 때문에 셸을 닫지 않습니다. 칸은 최대 16개까지 추가할 수 있고, 최소 크기인 280×180pt를 넘는 배치는 가로·세로 스크롤로 탐색합니다. 키보드로 포커스를 옮기면 해당 칸이 보이도록 스크롤합니다.

레이아웃 편집을 켜면 실행 중인 칸 중앙에도 추가 버튼이 나타납니다. 헤더의 이동 손잡이를 다른 칸으로 드래그하면 칸 전체 미리보기가 따라오고, 놓은 자리로 이동합니다. 셸과 실행 중인 프로세스는 유지됩니다. 빈 칸을 닫으면 인접 칸과 합쳐지며 마지막 한 칸은 남습니다.

_{넓게 볼 때는 탭으로. 다시 나눌 때도 기존 터미널은 그대로.}

GitHub 프로젝트 클론

터미널 추가 영역 하단의 다운로드 아이콘 또는 파일 → GitHub 프로젝트 클론…을 누릅니다. GitHub 저장소의 HTTPS·SSH 주소나 owner/repo를 입력하고, 저장 위치와 폴더 이름을 정한 뒤 클론하고 열기를 누르면 새 프로젝트 창에서 터미널이 실행됩니다. 파일 트리도 같은 폴더에서 시작합니다.

진행 중에는 취소할 수 있으며, 실패하면 입력을 유지해 수정한 뒤 다시 시도합니다. 같은 이름의 폴더나 파일을 덮어쓰지 않습니다. 비공개 저장소는 이 Mac에 설정된 Git credential helper나 SSH agent를 사용합니다. 인증 설정이 없거나 SSH 호스트를 아직 확인하지 않았다면 먼저 터미널에서 Git 인증을 설정해야 합니다. GitHub 계정 연결·저장소 목록 탐색·새 원격 저장소 생성은 포함하지 않습니다. 클론 후 의존성 설치나 저장소의 명령을 자동으로 실행하지 않습니다.

로컬 서버 주소

터미널에서 개발 서버를 실행하면 헤더에 localhost:3000 같은 주소가 표시됩니다. 하나면 클릭해 같은 창의 새 웹 칸으로 열고, 여러 개면 +1처럼 추가 개수와 함께 주소 목록을 제공합니다. 같은 주소가 이미 열려 있으면 그 칸으로 이동합니다. 주소를 우클릭하면 기본 브라우저로 열 수도 있습니다. 탭 보기에서는 선택한 터미널의 주소를 오른쪽에 표시합니다. 서버 종료·포트 변경은 약1초 간격으로 반영합니다. 좁은 칸에서는 :3000처럼 포트만 표시하며 전체 주소는 툴팁과 목록에 남습니다. 경로가 가려지면 칸 이름의 툴팁에서 확인합니다.

Chop이 연 셸과 그 자식 프로세스의 실제 TCP listener를 조회합니다. 루프백 또는 전체 인터페이스로 바인딩한 포트가 대상이며, 다른 터미널·외부 앱의 서버는 섞지 않습니다. 별도 권한 요청이나 서버 자동 접속은 없습니다. 서버 주소는 기본 HTTP로 엽니다. 현재 화면에 같은 포트의 로컬 주소(localhost·루프백·전체 인터페이스)가 있으면 화면상 마지막 주소의 HTTP/HTTPS를 반영하므로, 뒤에 나온 HTTP 주소가 앞선 HTTPS보다 우선합니다. 확인한 방식은 화면에서 힌트가 사라져도 해당 서버가 종료될 때까지 유지됩니다. TCP 포트만으로 HTTP 서비스 여부까지 판별하지는 않습니다. Docker/별도 데몬이 소유하거나 셸에서 완전히 분리된 서버, 원격 SSH 서버의 주소는 자동 표시하지 않습니다. 재실행 때 이전 주소를 저장해 보여주지 않습니다.

웹사이트 미리보기

오른쪽 추가 영역 하단의 지구본 아이콘 또는 ⌘⇧B로 웹 칸을 엽니다. 주소를 입력하고 Enter를 누르면 페이지가 표시됩니다. localhost:3000은 HTTP, 도메인만 입력하면 HTTPS로 엽니다. 빈 칸부터 채우고, 모두 차면 아래에 행을 추가합니다. 터미널과 웹 칸을 합해 최대 16개까지 열 수 있습니다.

뒤로·앞으로·새로고침과 로딩 중지를 지원합니다. 주소 입력창과 오른쪽 위의 브라우저에서 열기 버튼으로 주소를 바꾸거나 외부 브라우저로 이어갈 수 있습니다. 로컬 서버가 꺼져 있으면 주소와 실행 상태를 확인한 뒤 다시 불러오기를 누릅니다. 다운로드는 외부 브라우저를 이용합니다.

탭·격자·확대·자리 바꾸기는 같은 웹페이지를 유지하므로 입력 내용과 실행 중인 스크립트가 이어집니다. 웹 칸을 닫거나 앱을 종료한 뒤에는 주소만 복원하고 페이지를 새로 불러옵니다. 페이지의 입력 내용과 방문 기록은 작업 공간 파일에 저장하지 않습니다. 쿠키와 웹 저장소는 WebKit의 기본 저장소를 사용합니다. 미리보기는 HTTP·HTTPS 주소를 받으며, 인증서 오류는 기본 보안 처리를 따릅니다.

파일 트리

파일 트리는 공통 툴바 아래, 터미널 오른쪽에서 열립니다. ⌘⇧E로 표시하거나 숨기고, 경계를 드래그해 폭을 조절합니다. 경로를 입력한 뒤 Enter를 누르거나 ⌘O로 macOS 폴더 선택기를 열어 탐색할 폴더를 지정합니다.

폴더를 펼칠 때 하위 항목을 읽고, 폴더부터 정렬합니다. 숨김 항목은 제외하며 심볼릭 링크와 앱 패키지는 펼치지 않습니다. 파일을 더블 클릭하거나 Enter를 누르면 Finder에서 선택하고, 우클릭 메뉴나 ⌘C로 경로를 복사합니다. 실행 중인 터미널 본문으로 드래그해 경로를 넣을 수도 있습니다.

바로가기 아래 검색창에 이름을 입력하면 하위 폴더까지 검색합니다. 결과는 상대 경로로 표시하며, 검색어를 지우면 원래 트리로 돌아옵니다. 결과 폴더를 더블 클릭하거나 Enter를 누르면 그 폴더를 엽니다. 결과가 500개를 넘으면 검색어를 좁힐 수 있도록 안내합니다.

검색 중에도 찾은 항목부터 표시합니다. 검색어를 바꾸는 동안 읽은 폴더 목록을 최대 10초 동안 재사용하며, 새로고침이나 폴더 이동 시 캐시를 비워 새 파일과 삭제된 파일을 반영합니다.

파일 트리의 탐색 경로와 터미널의 작업 경로는 독립적입니다. 마지막 폴더와 패널 표시 여부, 폭은 다음 실행에도 유지됩니다. 읽기에 실패하면 경로 수정·폴더 선택·바로가기·새로고침으로 다시 시도할 수 있습니다.

시작하기

요구 사항

• macOS 14 이상
• Xcode 16 이상 / Swift 6 이상
• Xcode Command Line Tools (xcode-select -p로 확인)

소스에서 실행

git clone https://github.com/safethecode/chop.git
cd chop
./scripts/run.sh

첫 빌드는 공식 Ghostty 소스와 Zig 0.14.1을 내려받아 libghostty를 컴파일합니다. Metal 도구가 없으면 Xcode의 공식 MetalToolchain 구성 요소도 준비합니다. 이후에는 캐시를 재사용합니다. 고정 버전과 빌드 환경 안내는 의존성 문서에 있습니다.

디버그 앱은 build/debug/Chop.app에 생성됩니다. 이미 Chop이 실행 중이면 기존 앱을 활성화하므로, 변경한 코드를 실행하려면 먼저 앱을 종료합니다.

릴리스 앱 만들기

./scripts/build-app.sh release

build/release/Chop.app이 생성됩니다. 빌드 후 바로 실행하려면 ./scripts/run.sh release를 사용합니다. 현재는 개발용 임시 서명을 사용하며 외부 배포용 Developer ID 서명과 공증은 포함하지 않습니다.

단축키

동작	단축키
새 윈도우 / 프로젝트 폴더에서 새 윈도우	⌘N / ⌘⇧N
터미널 추가 / 현재 칸 닫기	⌘T / ⌘W
웹사이트 추가 / 웹 주소 입력	⌘⇧B / ⌘L
웹 새로고침 / 뒤로 / 앞으로	⌘R / ⌘[ / ⌘]
웹페이지 확대 / 축소 / 원래 크기	⌘= / ⌘- / ⌘0
오른쪽 / 아래로 나누기	⌘D / ⌘⇧D
레이아웃 편집	⌘⇧L
파일 트리 보기 / 숨기기	⌘⇧E
파일 트리의 폴더 선택	⌘O
인접 칸으로 이동	⌘⌥방향키
편집 중 인접 칸과 자리 바꾸기	⌘⌥⇧방향키
현재 칸 확대 / 전체 배치 복귀	⌘⇧Enter
현재 칸 이름 변경	⌘⇧R
스크롤백 맨 위 / 맨 아래	⌘↑ / ⌘↓
한 페이지 위 / 아래	⇧Page Up / ⇧Page Down
윈도우 닫기	⌘⇧W

탭 보기에서는 탭의 +로 추가하고 ⌘W로 선택한 탭을 닫습니다. 분할 보기의 빈 칸에서 ⌘W를 누르면 그 칸을 제거합니다.

**파일 → 프로젝트 폴더에서 새 윈도우…**에서 폴더를 고르면 해당 폴더를 셸과 파일 트리의 시작 경로로 사용합니다. 새 윈도우는 현재 선택한 터미널의 작업 폴더에서 시작합니다. 열린 창은 macOS 윈도우 메뉴에서 전환합니다. 모든 창을 닫아도 파일·Dock 메뉴에서 다시 열 수 있습니다.

데이터 저장과 복원

파일 → 최근 프로젝트에서 최근에 연 폴더12개를 다시 열 수 있습니다. 목록 지우기는 최근 이력만 지웁니다. 파일 → 작업 구성 → 현재 구성 저장…(⌘⇧S)에서 현재 배치·칸 이름·작업 경로·웹 주소와 파일 트리 설정을 이름 붙여 저장하세요. 같은 메뉴에서 구성을 고르면 새 창에서 열립니다. 현재 창의 작업은 유지합니다. 구성은 프로젝트마다20개, 전체100개까지 저장할 수 있고 구성 삭제…에서 정리합니다. 최근 목록과 구성은 ~/Library/Application Support/Chop/projects.json에 세션과 별도로 저장합니다. 기록 파일을 읽거나 검증하지 못하면 덮어쓰지 않습니다. 실행 명령과 환경변수는 구성에 포함하지 않습니다.

작업 공간은 Mac 안에 JSON 파일로 저장합니다.

~/Library/Application Support/Chop/
└── session.json

열린 창 목록과 선택한 창, 각 창의 레이아웃, 분할 비율, 칸 이름, 작업 경로, 열림 상태, 선택한 칸과 탭 보기 여부를 자동 저장합니다. 파일 트리의 경로·폭·표시는 창마다 기억합니다. 웹 칸은 종류와 주소도 저장합니다. 기존 단일 창 저장 파일도 읽습니다. 앱을 다시 열면 터미널 칸에는 새 셸을 실행하고 웹 칸은 주소를 새로 불러옵니다. 이전 프로세스, 셸 변수, 화면 내용과 명령 기록은 저장하거나 재실행하지 않습니다. 셸의 시작 설정과 히스토리는 사용자 설정을 따릅니다.

• 작업 폴더가 없거나 열 수 없으면 알림 후 홈 폴더로 대체합니다.
• 손상되거나 지원하지 않는 저장 파일은 session-unreadable-<UUID>.json으로 보존합니다.
• 저장 실패 시 터미널 메뉴의 레이아웃 다시 저장으로 재시도합니다. 저장하지 못한 채 종료하려면 확인을 거칩니다.
• 창을 직접 닫으면 그 창의 터미널만 종료하고 복원 목록에서 제외합니다. 앱 종료는 열려 있는 모든 창의 상태를 저장한 뒤 셸을 종료합니다.

기술 구성

영역	사용 기술
앱과 UI	Swift 6, AppKit, SF Symbols
터미널 엔진	libghostty, Metal
웹사이트 미리보기	WebKit, WKWebView
레이아웃과 저장	분할 트리, Codable, 로컬 JSON 파일
빌드	Swift Package Manager, 셸 스크립트
검증	swift-format, Swift Testing, 실제 셸 통합 테스트
CI	GitHub Actions · macOS

libghostty는 Ghostty v1.2.3의 특정 커밋으로 고정합니다. 엔진과 입력 어댑터의 연결 방식, 패치와 라이선스 고지는 Dependencies/README.md에 기록합니다.

개발과 검증

./scripts/check.sh

Swift 포맷, 셸 문법, 앱 메타데이터, 릴리스 빌드, 앱 서명과 번들 아이콘을 검사한 뒤 테스트를 실행합니다. GitHub Actions도 같은 명령을 사용합니다. 테스트는 분할·병합·저장 복구와 실제 셸의 출력·상태 유지·탭 전환·경로 드롭 등을 다룹니다.

Xcode에서 편집하려면 ./scripts/prepare-ghostty.sh를 실행한 뒤 Package.swift를 엽니다. 개발과 PR 절차는 CONTRIBUTING.md를 참고해 주세요. 검증 환경과 미확인 범위는 검증 기록에 남깁니다. macOS 14 실기기와 전체 VoiceOver 탐색, 마우스 휠의 실기 동작은 아직 검증하지 못했습니다.

프로젝트 구조

Sources/
├── Chop/             # 앱, 창, 터미널 입력과 렌더링, 파일 트리
└── ChopCore/         # 분할 모델, 경로 처리, 작업 공간 저장
Tests/
├── ChopTests/        # 실제 셸과 AppKit 통합 테스트
└── ChopCoreTests/    # 레이아웃과 저장·복구 테스트
Resources/            # 앱 아이콘, macOS 메타데이터, 터미널 테마
Dependencies/         # Ghostty 고정 버전, 패치와 빌드 결과
scripts/              # 의존성 준비, 빌드, 실행, 검증
.github/              # CI와 PR 템플릿
docs/images/          # README 앱 이미지
docs/showcase/        # 실제 캡처·배경·사진 구성 원본
design/               # 디자인 기준과 검증 기록

기여하기

버그 제보와 기능 제안은 Issues에 남겨 주세요. 문제가 생긴 macOS 버전, 재현 순서와 기대한 동작을 함께 적어 주시면 도움이 됩니다.

PR은 한 기능이나 수정 단위로 작게 나눕니다. 기본 검증은 ./scripts/check.sh이며, UI를 바꿨다면 실제 앱에서 확인한 화면과 동작을 기록합니다. 자세한 절차는 기여 가이드를 따릅니다.

현재 터미널·레이아웃·파일 트리·화면 모드·복원을 구현했습니다. 알림, Git 브랜치 표시, CLI와 브라우저·에이전트 연동은 후속 범위입니다.

바탕이 된 프로젝트

• Ghostty — libghostty 터미널 엔진과 macOS 입력 처리의 기반입니다. 라이선스 고지를 보존합니다.
• cmux — 작업 공간과 기능 구성에서 영감을 받았습니다.

앱 아이콘의 원본과 재생성 방법은 AppIcon 문서에 있습니다.

---

_{원하는 만큼 나누고, 한 창에서 이어서.}