QuickTerminal - 가이드

시작하기

1. 앱 실행 — 저장된 세션과 새 연결을 시작하는 버튼이 있는 홈 화면이 열립니다.
2. 로컬 셸 시작 — Local Shell을 탭하면 사용 중인 기기에서 터미널 세션이 즉시 열립니다.
3. 원격 세션 생성 — New Session을 탭하고 프로토콜(SSH, Telnet, Mosh, Serial, AWS SSM 또는 GCP IAP)을 선택한 뒤 연결 정보를 입력합니다.
4. 세션 저장 — 이름을 지정하고 그룹에 할당합니다. 언제든 한 번의 탭으로 다시 연결할 수 있습니다.
5. Command Palette 탐색 — Ctrl + Shift + P를 눌러 검색 가능한 단일 목록에서 모든 작업에 접근합니다.

인터페이스 개요

사이드바

접을 수 있는 사이드바가 작업 공간을 정리합니다:

• Sessions — 프로젝트나 환경별로 그룹화된 저장된 세션 전체
• SFTP — 활성 연결용 그래픽 파일 브라우저 열기
• Snippets — 저장된 명령 라이브러리
• AI Agent — AI 어시스턴트 패널 실행
• Settings / Help — 사이드바 하단에 위치

터미널 영역

중앙 작업 공간에는 다음이 표시됩니다:

• 완전한 입출력을 지원하는 활성 터미널
• 여러 열린 세션 간에 전환할 수 있는 탭 바
• 연결 상태, 프로토콜, 세션 타이머를 표시하는 하단 상태 표시줄
• 여러 터미널을 나란히 실행할 수 있는 선택적 분할 창 보기

Command Palette

Ctrl + Shift + P를 눌러 Command Palette를 엽니다. 입력하여 작업을 필터링한 뒤 Enter를 눌러 실행합니다. QuickTerminal의 모든 기능은 Command Palette를 통해 접근 가능합니다.

Local Shell

QuickTerminal에는 사용 중인 기기에서 명령을 실행할 수 있는 완전 통합형 로컬 셸이 포함되어 있습니다.

• 셸 감지 — 기본 셸(bash, zsh, fish, PowerShell)을 자동으로 감지하고 사용
• 작업 디렉터리 추적 — 상태 표시줄에 현재 디렉터리가 항상 표시됨
• 명령 기록 — 세션 간에 유지되며 Ctrl + R로 검색 가능
• 환경 변수 — 셸 프로필과 환경을 자동으로 상속

$ echo "Welcome to QuickTerminal"
Welcome to QuickTerminal
$ ssh user@server.example.com
# Or create a saved session for one-tap reconnection

SSH 연결

SSH는 안전한 원격 접속을 위한 주요 프로토콜입니다. QuickTerminal은 모든 최신 SSH 기능을 지원합니다.

인증

• 비밀번호 — 연결 시 자격 증명을 입력하거나 세션에 안전하게 저장
• 키 기반 — RSA, Ed25519 또는 ECDSA 키 사용. 파일에서 가져오거나 새 키 쌍 생성 가능
• 에이전트 전달 — 로컬 SSH 에이전트를 원격 호스트로 전달하여 원활한 다단계 접속 구현
• 키보드 인터랙티브 — 이중 인증 및 챌린지-응답 프롬프트 지원

포트 포워딩

• 로컬 포워딩 — 원격 포트를 로컬 기기로 터널링
• 원격 포워딩 — 로컬 서비스를 원격 호스트에 노출
• 동적 포워딩 — SSH 터널을 통해 SOCKS 프록시 생성

세션 구성

# Example session fields
Host:       server.example.com
Port:       22
Username:   deploy
Auth:       Key (Ed25519)
Forwarding: Local 8080 → remote 80

기타 프로토콜

Telnet

호스트와 포트를 구성합니다. Telnet 연결은 암호화되지 않습니다. 신뢰할 수 있는 네트워크 또는 반드시 필요한 장비에서만 사용하세요.

Mosh

원격 호스트에 Mosh 서버가 설치되어 있어야 합니다. QuickTerminal이 초기 SSH 핸드셰이크와 UDP 세션 설정을 자동으로 처리합니다. 모바일이나 불안정한 네트워크 환경에 이상적입니다.

Serial

시리얼 포트, 보드 레이트(9600, 19200, 38400, 57600, 115200 등), 데이터 비트, 정지 비트, 패리티, 흐름 제어를 선택합니다. 터미널은 원시 시리얼 데이터를 표시하고 브레이크 신호 전송을 지원합니다.

AWS SSM

AWS 자격 증명이나 IAM 역할로 인증합니다. ID 또는 이름으로 대상 인스턴스를 선택합니다. QuickTerminal은 SSM 세션 플러그인을 호출하여 연결을 설정합니다.

GCP IAP

Google Cloud 계정으로 인증합니다. 프로젝트, 영역, 인스턴스를 선택합니다. QuickTerminal은 IAM 권한을 사용하여 IAP를 통해 터널링합니다.

SFTP 브라우저

내장 SFTP 브라우저는 SSH 연결된 모든 호스트에 대해 그래픽 파일 관리자를 제공합니다.

• 디렉터리 탐색 — 익숙한 트리 및 목록 보기로 원격 파일 시스템 탐색
• 파일 업로드 — 로컬 기기에서 파일을 드래그 앤 드롭하거나 업로드 버튼 사용
• 파일 다운로드 — 파일을 선택하여 로컬 디렉터리로 다운로드
• 원격 편집 — 내장 에디터로 텍스트 파일을 열고 서버에 직접 저장
• 권한 — 파일 권한, 소유권, 타임스탬프를 확인하고 수정
• 검색 — 현재 디렉터리 트리 내에서 이름으로 파일 찾기

AI 에이전트

QuickTerminal의 AI 에이전트는 명령 작성, 출력 분석, 작업 자동화를 지원합니다.

AI 에이전트가 할 수 있는 일

• 명령 생성 — 원하는 내용을 자연어로 설명하면 에이전트가 적절한 명령을 제안
• 출력 설명 — 터미널 출력을 붙여넣거나 파이프하면 사람이 읽기 쉬운 형식으로 분해해 설명
• 오류 진단 — 오류 메시지를 공유하면 해설과 함께 수정 제안 제공
• 다단계 자동화 — 워크플로를 설명하면 에이전트가 명령 시퀀스 생성
• 스크립트 생성 — 반복 작업용 셸 스크립트 생성 요청 가능

에이전트 패널 사용

1. 사이드바에서 AI Agent 패널을 열거나 Ctrl + Shift + A를 누릅니다.
2. 자연어로 요청을 입력합니다.
3. 제안된 명령이나 설명을 검토합니다.
4. Insert를 클릭하여 명령을 터미널에 붙여넣거나 Copy로 클립보드에 복사합니다.

Snippets

Snippets를 사용하면 자주 쓰는 명령을 저장, 정리하고 빠르게 삽입할 수 있습니다.

스니펫 만들기

1. 사이드바에서 Snippets 패널을 엽니다.
2. New Snippet을 탭합니다.
3. 명령, 이름, 선택적 설명을 입력합니다.
4. 매개변수화된 템플릿에는 ${variable_name} 구문을 사용합니다.
5. 스니펫 라이브러리에 저장합니다.

템플릿 변수

# Snippet with variables
$ ssh ${user}@${host} -p ${port:22}
# ${port:22} uses 22 as default if not specified

매개변수화된 스니펫을 삽입할 때 QuickTerminal은 최종 명령을 삽입하기 전에 각 변수의 값을 입력하도록 요청합니다.

스니펫 정리

• 관련 스니펫을 그룹화하기 위해 태그 할당(예: deployment, monitoring, database)
• 이름, 내용 또는 태그로 스니펫 검색
• 가장 많이 사용하는 스니펫을 고정하여 목록 상단에서 빠르게 접근

Command Palette

Command Palette는 QuickTerminal 어디에서든 접근할 수 있는 범용 작업 실행기입니다.

• Ctrl + Shift + P를 눌러 열기
• 입력하여 작업 필터링 — 퍼지 매칭으로 필요한 항목을 빠르게 찾음
• 작업 예: 세션 생성, SFTP 열기, 설정 전환, 스니펫 실행 등
• 최근 사용한 작업이 상단에 표시되어 반복 접근이 빠름

# Example palette actions
New SSH Session
Open SFTP Browser
Insert Snippet...
Toggle Split Pane
Open AI Agent
Manage Execution Policies

Execution Policies

Execution Policies를 사용하면 실수나 파괴적인 명령으로부터 보호하는 안전 규칙을 정의할 수 있습니다.

정책 유형

정책 구성

1. Settings > Execution Policies로 이동합니다.
2. New Policy를 탭합니다.
3. 패턴을 정의합니다 — 일치시킬 명령 접두사, 정규식 또는 키워드.
4. 작업(block, confirm, sandbox 또는 log)을 선택합니다.
5. 범위를 설정합니다 — 모든 세션, 특정 그룹 또는 개별 세션에 적용.

설정

외관

• 테마 — 시스템 기본 설정을 감지하는 라이트 및 다크 모드
• 글꼴 패밀리 — 터미널에서 사용할 선호하는 고정폭 글꼴 선택
• 글꼴 크기 — 조정 가능한 터미널 텍스트 크기
• 색상 스킴 — 내장된 터미널 색상 팔레트에서 선택하거나 사용자 지정 스킴 가져오기

터미널

• 스크롤백 버퍼 — 메모리에 보관할 히스토리 행 수 구성
• 커서 스타일 — 블록, 밑줄 또는 바
• 벨 동작 — 시각적 플래시, 시스템 소리 또는 무음
• 선택 시 복사 — 강조 표시한 텍스트를 자동으로 클립보드에 복사

연결

• 기본 SSH 포트 — 새 SSH 세션용 사용자 지정 기본 포트 설정
• Keep-alive 간격 — 연결 타임아웃을 방지하기 위해 주기적인 패킷 전송
• 연결 끊김 시 재연결 — 끊어진 연결의 복원을 자동으로 시도

Execution Policies

• block, confirm, sandbox 및 log 규칙 관리
• 세션 그룹별로 정책 활성화 또는 비활성화

키보드 단축키

팁 & 트릭

문제 해결

개인정보 보호

• QuickTerminal은 계정이나 로그인을 요구하지 않습니다.
• 사용 데이터, 분석 또는 텔레메트리가 수집되지 않습니다.
• 모든 자격 증명은 플랫폼 기본 키스토어를 사용해 암호화됩니다.
• AI 에이전트는 완전히 기기에서 실행됩니다 — 외부 서버로 데이터가 전송되지 않습니다.
• 세션 기록과 스니펫은 기기에 로컬로 저장됩니다.
• SFTP 전송은 사용자의 기기와 원격 호스트 간에 직접 이루어집니다.
• 로컬 셸 및 시리얼 연결에서는 앱이 완전히 오프라인으로 작동합니다.