Android

Android에서도 같은 순서로, 그리고 다른 점.

앱은 Google Play에서 받습니다: https://play.google.com/store/apps/details?id=io.sophonz.st. Google Play를 쓰지 않으면 서명된 APK가 있습니다: https://dl.sophonz.io/apps/android/latest/st-android.apk (항상 최신 버전). 폰의 브라우저에서 열고 처음이면 "알 수 없는 앱 설치"를 허용합니다.

앱을 처음 열면 빈 머신 탭이 나옵니다. 설치 명령이 탭 세 개로 나뉘어 있어서 폰에서 바로 복사할 수 있습니다.

처음 열면 앱이 짧은 가이드로 버튼을 하나씩 짚어 주고, 첫 터미널에서도 한 번 더 짚어 줍니다. 영상과 단계 전체는 앱 처음 실행하기에 있습니다.

1. 컴퓨터에서 세션 시작

세션은 컴퓨터에 있고, 처음부터 끝까지 거기에 열려 있습니다. 폰은 그 세션에 들어가는 것이지 가져가는 것이 아닙니다. 먼저 st를 설치합니다.

curl -fsSL https://dl.sophonz.io/install.sh | sh

brew trust --tap sophonz-labs/tap
brew install sophonz-labs/tap/st

irm https://dl.sophonz.io/install.ps1 | iex

그리고 열어 두려는 터미널에서 실행합니다.

st

링크 하나와, 같은 링크의 QR 코드가 나오고 그때부터 세션이 공유됩니다. 그대로 켜 두세요. st ls에서 Enter를 누르면 직접 그 세션에 들어가 계속 작업할 수 있고, 나중에 들어오는 브라우저와 폰도 같은 셸을 봅니다. 플랫폼별 자세한 내용은 설치에 있습니다.

2. 머신 추가

+를 누르고 방법을 고릅니다.

• Scan QR — st가 시작할 때 띄우는 코드.
• Paste link — ?k=가 붙은 링크, 또는 계정의 고정 link.sophonz.io 링크.
• Manual — 터널 주소와 토큰을 따로 입력.

추가하기 전에 그 링크가 어느 머신을 가리키는지 시트에 표시됩니다. 이름은 넣고 싶으면 넣고, Add를 누릅니다.

링크를 앱으로 공유해도 됩니다. 채팅이나 메모, 브라우저에서 링크를 길게 눌러 공유를 고르고 앱을 선택하면, 링크가 채워진 추가 시트가 열립니다.

3. 세션 고르기

세션 탭에는 그 머신의 tmux 세션이 모두 나옵니다. 창이 몇 개인지, 무엇이 실행 중인지, 언제 마지막으로 썼는지도 함께 보입니다. 하나를 눌러 열거나, 새 세션으로 새로 시작합니다.

세션을 닫으려면 행을 밀거나 길게 눌러 세션 닫기를 고릅니다. 창도 창 목록에서 같은 방법으로 닫습니다. 앱은 닫기 전에 항상 묻습니다. 셸만 있으면 셸이 종료된다고만 하고, 프로그램이나 에이전트가 아직 실행 중이면 에이전트부터 이름을 대서("이 윈도우에서 Claude Code 에이전트가 작업 중이에요. 함께 실행 중: npm.") 오래 걸리는 작업을 실수로 멈추지 않게 합니다. st가 이 기능보다 오래된 머신에서는 무엇이 실행 중인지 알 수 없다고 말합니다.

머신 탭이나 세션 탭에서 세션을 누르면 창이 하나여도 창 목록부터 열립니다. 창마다 실행 중인 프로그램과 에이전트가 보이고, 마지막에 있던 창이 표시돼 있습니다. 창을 누르면 그 창의 터미널이 열리고, 뒤로 가면 창 목록, 세션, 머신 순으로 돌아갑니다. 목록을 건너뛰려면 세션을 길게 눌러 터미널 열기를 고릅니다. 알림, 위젯, 링크는 지금처럼 바로 터미널을 엽니다.

4. 터미널

위쪽 막대의 알약에 머신, 세션, 창이 표시됩니다. 알약을 누르면 세션, 창, pane을 고르는 시트가 열리고, 길게 누르면 지금 창의 이름을 바꿉니다. 나머지는 ⋮에 있습니다.

키바

iPhone과 순서가 다릅니다. Android에서는 멀티플렉서 줄이 맨 아래, 엄지에 가장 가까운 자리에 있습니다. 화면이 좁으면 에이전트 줄과 멀티플렉서 줄이 먼저 빠집니다. 키를 길게 누르면 무엇을 보내는지 보여 주고, 줄과 키는 설정 → 키와 입력 → 키 바 → Layout이나 키맵 파일로 바꿀 수 있습니다 — 키바 참고. 터미널을 두 손가락으로 벌리거나 오므리면 A−·A+처럼 글자 크기가 바뀝니다.

키바 닫기. 아래로 내리면 한 번에 하나씩 치웁니다. 터미널을 한 번 내리면 화면 키보드가 내려가고 키바는 남습니다. 바로 한 번 더 내리면 키바도 숨겨집니다(처음 한 번은 안내가 뜹니다). 그 밖에 아래로 끄는 것은 전처럼 지난 출력을 스크롤합니다. 키보드 키와 키바를 아래로 끌기도 같은 두 단계입니다. 먼저 화면 키보드, 그다음 키바. 키바를 닫으면 터미널이 화면을 다 쓰고, 오른쪽 아래의 작은 키보드 버튼을 누르면 키바와 키보드가 함께 돌아옵니다. 터미널을 눌러도 됩니다.

하드웨어 키보드(블루투스, USB)를 연결하면 키바는 처음부터 닫혀 있습니다. 키는 키보드에 있으니까요. 키보드 버튼으로 열면 화면 키보드 없이 키바만 뜨고, 키바의 키보드 키나 Meta+Shift+B로 다시 닫습니다. 키바를 열어 두었는지는 하드웨어 키보드가 있을 때와 없을 때를 따로 기억합니다. 하드웨어 키보드와 함께 늘 열어 두려면 설정 → 키와 입력 → 키 바 → 하드웨어 키보드를 연결하면 키 바 숨기기를 끕니다.

음성

받아쓰기는 Android 자체 음성 인식을 씁니다. 폰에 그 언어의 모델이 있으면 기기 안에서 처리됩니다. 마이크를 탭하면 시작하고 말풍선에 인식된 내용이 보입니다. 마이크를 한 번 더 탭하거나 Send를 누르면 끝납니다. 모드는 말풍선에서 고릅니다.

• Chat — 말한 내용을 입력하고 Enter까지 누릅니다.
• Command — 입력만 합니다.

처음 한 번은 Android가 마이크 권한을 묻습니다.

작성

연필 키를 누르면 긴 프롬프트를 쓰는 입력칸이 열립니다. 일반 입력칸이라 한글 키보드도 평소처럼 조합됩니다. 보내기는 줄 사이를 Alt+Enter로, 끝을 Enter로 보내 한 메시지로 넣습니다. 입력칸 아래 버튼은 아이콘이고 iPhone과 같은 여섯 개입니다.

버튼을 길게 누르면 이름과 하는 일이 보입니다.

에이전트에게 파일. 첨부한 파일은 입력칸 위에 칩(미리보기나 이름)으로 보이고, 그 경로(머신의 ~/.sophonz/uploads, 일주일 보관)가 초안에 들어갑니다. 사진은 긴 변 2048 px 이하의 JPEG로 갑니다. 칩을 누르면 지금 터미널에 붙여넣기(이미 기다리는 에이전트에게 경로를 바로 붙여넣기)와 빼기(초안의 경로도 지움)가 있습니다. Claude Code, Codex, Gemini CLI는 경로로 사진이나 파일을 읽습니다. pane이 승인이나 질문을 기다리는 동안에는 st 0.3.71 이상이 지금 터미널에 붙여넣기를 받지 않고 앱이 그 이유를 알려 줍니다. 에이전트가 붙여넣은 경로를 답으로 받아들이기 때문입니다. 먼저 답하고 다시 붙여넣습니다.

선택과 복사

터미널에서 단어를 길게 누르면 그 단어가 선택되고, 양 끝에 핸들이, 위에 메뉴가 뜹니다. 복사, 모두 선택, .md로 저장, 공유, 링크를 눌렀다면 링크 복사와 링크 열기도 있습니다. 핸들을 끌어 범위를 바꾸고, 핸들을 화면 위나 아래 끝에 대고 있으면 스크롤백이 따라 움직입니다.

복사하면 평문이 들어갑니다. 줄 끝 공백은 빠지고, 화면에서 접혀 보인 긴 줄은 한 줄로, 줄바꿈은 프로그램이 넣은 자리에만 들어갑니다. 한글 같은 넓은 글자, 경로, 옵션, 링크는 통째로 나옵니다. 모두 선택은 터미널이 가진 것 전부를 고릅니다. tmux에서는 pane에 보이는 만큼이니 먼저 드래그로 스크롤하세요. 아무 데나 탭하거나, 입력하거나, 뒤로 가기를 누르면 선택이 끝납니다. tmux 마우스가 켜져 있어도 길게 누르기와 그 탭은 앱 안에서 끝납니다.

창

알약을 누르면 머신 이름이 제목인 시트가 열립니다. 맨 위가 지금 세션이고 그 아래에 세션의 창이 하나씩 카드로 나옵니다. 여러 pane으로 나뉜 창은 카드 안에 pane도 나옵니다. 다른 세션 아래에는 그 머신의 나머지 세션이 접혀 있습니다. 세션을 누르면 그 세션의 창이 펼쳐지고 그 창이나 pane을 누르면 터미널이 그리로 옮겨 갑니다.

창은 눌러서 이동하고 밀어서 닫고 길게 눌러 이름 바꾸기와 윈도우 닫기를 고릅니다. 줄 끝 버튼은 창에 채팅이 있으면 채팅, 없으면 이름 바꾸기입니다. 이름 바꾸기와 닫기는 지금 세션의 창에만 있습니다. 닫을 때는 먼저 묻고 아직 실행 중인 것을 알려 줍니다. 마지막 창을 닫으면 세션이 끝나고 세션 목록으로 돌아갑니다. 세션은 세션 줄을 길게 눌러 닫습니다. 새 창은 위쪽 새 윈도우로 만들고, 만들 때 바로 이름을 묻습니다. Skip을 누르면 tmux가 붙인 이름을 씁니다. st 0.3.58부터는 새 윈도우에 그 머신에 설치된 코딩 에이전트(Claude Code, Codex, Gemini CLI)도 나옵니다. 하나를 고르고 원하면 첫 프롬프트를 쓰면, st가 창을 열어 에이전트를 띄우고 준비되면 프롬프트를 칩니다.

tmux가 멈춘 뒤 st가 다시 구성한 창에는 restored 표시가 붙습니다. 에이전트는 대화를 스스로 이어 가며, st가 이어가기 명령을 입력만 해 둔 에이전트 창에는 Enter를 기다린다는 안내가 표시됩니다. 멀티플렉서 참고.

창 안에서 실행 중인 것

창 목록과 알약 시트의 창 아래에 그 창에서 실행 중인 것이 나옵니다. 코딩 에이전트의 서브에이전트가 하나씩, 종류와 에이전트가 붙인 짧은 설명, 실행 중인지 끝났는지 확인 불가인지, 얼마나 됐는지와 함께 나옵니다. 한 창에 에이전트가 여럿이면 에이전트마다 한 줄이 있고 그 아래에 서브에이전트가 나옵니다.

서브에이전트는 서브에이전트 · 실행 중 2, 끝남 5 머리 줄 아래에 있습니다. 머리 줄을 누르면 목록이 열리고 닫힙니다. 실행 중인 서브에이전트가 있으면 열린 채로, 없으면 닫힌 채로 시작합니다. 끝난 서브에이전트는 맨 아래 끝난 서브에이전트 5개 묶음에 최근 것부터 들어가고, 누르기 전에는 닫혀 있습니다. 리더의 팀원도 팀원 머리 줄 아래에서 똑같이 움직이고, 끝났거나 팀이 끝난 팀원은 끝난 팀원 묶음에 들어갑니다. 열고 닫은 상태는 앱을 닫을 때까지 그 창과 에이전트마다 그대로 갑니다. 새 서브에이전트가 생기면 개수만 바뀌고 닫아 둔 목록은 열리지 않습니다. TalkBack은 머리 줄을 개수와 펼침·접힘 상태가 있는 버튼으로 읽습니다.

tmux 분할 pane에서 실행되는 Claude Code 에이전트 팀은 리더 아래에 팀원마다 상태와 실행 중인 서브에이전트 수로 묶여 나옵니다. 팀원(또는 에이전트)을 누르면 그 창이 열리고 그 pane이 확대됩니다. 팀이 끝났는데 아직 실행 중인 팀원은 팀 끝남으로 표시되고, 그 창과 세션에도 같은 표시가 붙습니다. 밀어서 닫으면 됩니다. 훅(st hooks install)과 st 0.3.42 이상이 필요합니다. 그보다 오래된 st에서는 서브에이전트가 몇 개 실행 중이고 몇 개 끝났는지만 나옵니다.

코디네이터와 워커

에이전트가 오케스트레이션으로 다른 에이전트에게 일을 맡기면, 앱은 누가 누구의 일을 하는지 보여 줍니다. 이 머신뿐 아니라 같은 계정의 다른 머신도 함께 보여 줍니다.

• 에이전트 차트. 맨 위에 코디네이터가 있고 그 아래로 딸린 에이전트가 선에 매달린 카드 트리입니다. 워커의 선은 굵은 초록, 팀원은 파랑, 서브에이전트는 가는 회색이고, 일하는 동안에는 선이 진해집니다. 카드에는 에이전트의 아이콘과 이름, 코디네이터·워커·서브에이전트·팀원 배지, 상태와 그 상태가 된 지 얼마나 됐는지, 세션과 창이 나오고, 다른 머신의 카드에는 그 머신 이름이 붙습니다. 위쪽 칩으로 이 창(터미널에서 열었을 때), 이 세션, 이 머신, 모든 머신(로그인했을 때)을 오갑니다. 다른 머신의 워커도 같은 트리에 들어갑니다. 에이전트 카드를 누르면 그 창과 pane에서 터미널이 열리고(다른 머신이면 그 머신을 먼저 엽니다), 서브에이전트나 팀원 카드를 누르면 자세한 정보가 나옵니다. 차트는 머신 화면의 ⑂ N 칩, 터미널 ⋮ 메뉴의 에이전트, 세션 창 목록 위쪽의 워커 버튼에서 엽니다.
• 창 목록. 코디네이터의 창에는 코디네이터 배지와 ⑂ 워커 N 알약이 붙습니다. 워커는 처음에 펼쳐져 있고, 알약을 누르면 접힙니다. 같은 세션의 워커는 그 아래에 들어가고, 다른 세션의 워커는 그 세션과, 다른 머신의 워커는 머신 아이콘과 이름과 함께 한 줄씩 나옵니다. 코디네이터가 다른 머신에 있는 워커는 제자리에 남고, 그 창에 "home-macbook의 coordinator 워커"처럼 <머신>의 <부모> 워커라고 나옵니다.
• Agents 카드. 앞에 있는 창에서 코디네이터나 워커가 실행 중이면 터미널 오른쪽 위에 ⑂ N 알약이 나옵니다. 누르면 코디네이터와 워커가 상태와 함께 나오고, 줄을 누르면 그 pane이 어디에 있든 그리로 갑니다.
• 워커로 맡기기와 놓아 주기. 에이전트의 창이나 차트의 카드를 길게 누릅니다. 워커로 맡기기…를 누르면 누구의 워커로 할까요?가 열리고, 내 머신들에서 이 에이전트를 워커로 데려올 수 있는 에이전트가 나옵니다. 데려올 수 없는 에이전트는 흐리게 나오고 그 이유가 붙습니다. 데려온 워커는 지금까지의 대화를 그대로 갖고 갑니다(데려오기). 워커에서 놓아 주기를 누르면 누구의 워커도 아니게 됩니다. 데스크탑 앱의 끌어 놓기를 이 메뉴가 대신합니다.

Android 앱 0.1.94 이상에 있고, 오케스트레이션을 실행하는 st 0.3.67 이상이 필요합니다. 워커로 맡기기와 놓아 주기는 st 0.3.70 이상이 필요합니다. 다른 머신의 에이전트를 워커로 데려오려면 두 머신 모두 st 0.3.85 이상이어야 하고, 워커가 될 머신이 다른 머신의 워커를 받도록 켜 두어야 합니다(그 머신에서 st orch accept-remote on). 켜져 있는지는 그 머신의 st와 에이전트 훅 시트에 다른 기기의 워커 받기가 켜짐인지 꺼짐인지로 나옵니다. 다른 머신의 에이전트 데려오기를 보세요.

Pane

여러 pane으로 나뉜 창은 배치 지도부터 엽니다. pane마다 있는 자리에 그 프로그램의 아이콘과 이름, 에이전트 상태가 나오고 활성 pane에 테두리가 있습니다. 창 줄에는 pane이 몇 개인지 나옵니다. pane을 누르면 그 자리에서 터미널이 열립니다. 폰에서는 그 pane이 화면을 채우고(tmux 확대), 태블릿에서는 창의 나머지와 함께 열립니다. 설정 › 모양 › 터미널 › Pane › pane을 확대해서 열기로 바꿉니다. 창 전체 열기는 창을 그대로 엽니다.

터미널에서 다른 pane으로 옮기려면 알약 시트에서 나뉜 창 아래의 pane을 누르거나, 메뉴의 Pane으로 같은 지도를 엽니다. 앱이 한 확대는 터미널을 나가거나 다른 창으로 갈 때 되돌리므로, 컴퓨터 앞의 사람이 확대된 창을 보게 되지 않습니다. 원래 확대돼 있던 창과 키 바의 zoom으로 직접 한 확대는 그대로 둡니다. TalkBack은 pane을 "pane 2, Codex, 입력 대기, 오른쪽 위"처럼 읽습니다. st 0.3.56 이상과 tmux가 필요합니다. pane이 하나인 창, 그보다 오래된 st, zellij에서는 바로 터미널이 열립니다.

채팅

창에서 Claude Code나 Codex가 st 훅과 함께 실행되면 터미널 머리 줄에 터미널 | 채팅 전환이 생깁니다. 채팅은 화면 대신 에이전트와의 대화를 메시지로 보여 줍니다. 내가 한 말은 오른쪽에, 에이전트의 답은 서식 있는 글로, 에이전트가 쓴 도구는 이름과 대상이 있는 한 줄로 나옵니다. 줄을 누르면 입력과 출력이 보이고, 편집은 줄 번호와 빨강·초록으로 바뀐 곳을 보여 줍니다. 생각은 한 줄로 접혀 있고, 서브에이전트는 종류와 설명이 나오며(누르면 그 창의 서브에이전트), 긴 출력에는 전체 보기가 있습니다. 새 메시지는 에이전트가 쓰는 대로 들어오고, 위로 올리면 이전 메시지가 나옵니다.

에이전트가 질문을 기다리면 대화 끝에 답하기가 있는 카드로 나오고, 아래 입력 줄은 답할 때까지 기다립니다. 아래 입력 줄에 쓰면 에이전트에게 보냅니다. st 0.3.63 이상이면 st가 내 컴퓨터에서 에이전트의 입력창에 직접 쳐 주고, 보낸 글은 바로 보내는 중…으로 보였다가 대화에 들어올 때까지 보냄으로 남습니다. 확인하지 못하면 확인 안 됨 · 터미널에서 확인하세요(에이전트가 일하는 중이면 대기 중)라고 하고, 두 번 보내지 않습니다. 컴퓨터에서 이미 친 글이 있으면 그 글을 보여 주며 컴퓨터에서 친 글을 바꿀까요?라고 먼저 묻습니다. 에이전트가 일하는 동안에는 보내기 자리에 빨간 멈추기가 나와, 컴퓨터에서 Esc를 누른 것처럼 그 턴을 멈춥니다. 클립 버튼으로 사진이나 파일을 붙이면 머신으로 올라가고 그 경로가 내 말 뒤에 붙습니다. 옛 st에서는 작성(Compose)처럼 보냅니다.

터미널은 밑에서 연결된 채로 있고, 앱은 pane마다 마지막에 본 쪽을 기억합니다. 창 목록과 알약 시트에서도 창의 채팅으로 바로 열 수 있고(줄의 채팅 버튼, 이때 이름 바꾸기는 줄을 길게 눌러서), 여러 pane으로 나뉜 창의 pane 지도에는 에이전트 pane마다 채팅 버튼이 있으며, 에이전트 알림에는 채팅으로 열기가 있습니다. 채팅은 에이전트가 내 컴퓨터에 쓰는 기록을 터미널처럼 직접 읽어 옵니다. st 0.3.57 이상이 필요합니다. trycloudflare.com 주소로 연결해도 st 0.3.67 이상이면 에이전트 상태와 채팅이 바로바로 들어옵니다. 그보다 오래된 st에서는 몇 초마다 새로 읽어 옵니다.

일부만 복사하기. 채팅의 글은 길게 눌러 끌면 원하는 부분만 고를 수 있습니다. 메뉴의 복사로 복사합니다.

파일과 변경 사항

터미널에 프로그램이 찍은 파일 경로(src/auth.go:42:7, ./README.md 같은)는 링크입니다. 누르면 그 줄에서 파일을 미리 봅니다. 코드는 줄 번호와 간단한 색으로, 마크다운은 렌더링해서, 그림은 화면에 맞춰 보여 줍니다. 메뉴에는 경로 복사, Compose에 넣기, 공유가 있습니다. 채팅의 도구 호출이 읽거나 바꾼 파일도 같은 식으로 열립니다. 비밀 정보가 있을 수 있는 파일(.env, 키)은 컴퓨터 밖으로 나오지 않습니다.

터미널 ⋮ 메뉴의 변경 사항은 pane의 git 변경을 작업 중·스테이지됨으로 나눠 보여 주고, 파일마다 줄 번호가 있는 diff를 엽니다. 줄을 길게 눌러 에이전트에게 남길 메모를 쓰면 Compose에 메모 넣기가 path:줄 — 메모 형태로 초안에 넣습니다. 스테이지나 커밋은 하지 않습니다.

빠른 프롬프트는 머신에 저장되어, 그 머신의 터미널을 여는 모든 폰이 같은 목록을 씁니다. 모두 st 0.3.62 이상이 필요합니다.

GitHub Actions

터미널 ⋮ 메뉴의 Actions는 화면에 있는 pane이 들어 있는 저장소의 GitHub Actions 실행을 보여 줍니다. 목록은 이 브랜치로 열리고 옆에 전체가 있습니다. 실행마다 상태, 제목, 워크플로와 실행 번호, 브랜치, 마지막으로 바뀐 때가 나옵니다. 위의 ↻를 누르면 새로 읽습니다. 대기 중이거나 진행 중인 실행이 있으면 10초마다 다시 읽습니다.

실행을 누르면 작업과 그 단계가 걸린 시간과 함께 나오고 GitHub에서 열기가 있습니다. 실패한 실행에는 실패 로그(실패한 단계의 마지막 400줄)와 실패한 작업 다시 실행, 끝난 실행에는 다시 실행, 아직 진행 중인 실행에는 실행 취소가 있고 취소는 한 번 묻습니다. 보기 전용 링크로는 보기만 합니다.

st는 이 모든 것을 그 머신의 GitHub CLI와 그 로그인으로 읽고, GitHub 토큰을 직접 들고 있지 않습니다. 그래서 머신에 gh가 설치돼 있고 로그인돼 있어야 합니다. 빠진 것이 있으면 시트가 무엇인지 알려 줍니다. 이 머신에 gh가 없습니다, gh에 로그인되어 있지 않습니다(머신에서 gh auth login), GitHub 저장소가 아닙니다, pane의 폴더가 git 체크아웃 안에 없으면 git 체크아웃이 아닙니다입니다. st 0.3.74 이상과 tmux(Windows는 psmux)가 필요합니다.

5. 다음부터는

머신은 머신 탭의 Saved 아래에 마지막으로 연결된 시각과 함께 저장됩니다. 한 번 누르면 세션 목록이 열립니다.

머신이 온라인이 아닐 때

폰이 닿지 못하는 머신은 머신 탭에서 흐리게, 상태와 마지막 접속 시각과 함께 나옵니다.

머신을 누르면 연결을 시도하는 대신 같은 설명과 복사할 명령을 보여 줍니다. 세션 목록은 에이전트의 마지막 상태와 함께 남습니다. 터미널을 연 채로 머신이 사라지면 터미널은 재연결을 멈추고 어떤 상태인지 알려 주고, 머신이 돌아오면 다시 연결합니다.

오프라인 말고는 모두 계정에서 오는 상태라, 앱에 로그인해 있고 그 머신의 st가 v0.3.32 이상이어야 합니다. 같은 상태가 대시보드에도 나옵니다.

머신의 st가 다시 시작해 주소나 토큰이 바뀌어도, 계정에 있는 머신이면 앱이 새 주소를 따라갑니다. 열어 둔 터미널의 토큰이 거부되면 QR 코드를 다시 찍으라고 하는 대신 머신 화면으로 돌아가 세션을 다시 열라고 알려 줍니다.

연결 점검(머신 줄이나 세션 목록 위의 ⋮, 터미널 ⋮)은 sophonz, 머신 하트비트, 터널 주소, st, 실시간 연결, 지연 시간을 차례로 확인하고 어디서 응답이 끊기는지, 무엇을 하면 되는지 알려 줍니다. 결과 복사는 주소나 키 없이 결과를 복사합니다. st 0.3.62 이상이 필요합니다.

큰 화면으로

USB-C나 HDMI 디스플레이 어댑터를 꽂거나, Smart View나 화면 전송(Miracast)으로 TV에 화면을 보내면 열려 있던 터미널이 그 화면을 가득 채웁니다. 폰 화면을 복사하는 것이 아니라 터미널을 그 화면 해상도대로 다시 그립니다.

폰은 그동안 입력하는 기기로 남습니다. 키바, 키보드, Compose, 제스처가 그대로 있고, 위쪽 띠가 터미널이 어디에 어떤 크기로 떠 있는지 알려 줍니다. 그 아래에 폰이 보여 줄 것을 고릅니다.

• 작은 미리보기: 같은 터미널을 폰에 맞게 줄여서 보여 줍니다.
• 키보드만: 안내 문구만 둡니다. 빈 곳을 끌면 스크롤, 두 손가락으로 창을 전환합니다.

띠의 버튼이나 터미널 메뉴에서 바로 바꿀 수 있습니다. 연결된 동안 핀치나 A−/A+는 큰 화면의 글자 크기를 바꿉니다.

크기에 관해 하나: 연결된 동안 창 크기는 큰 화면의 것입니다. 키보드가 올라와도 큰 화면은 그대로입니다. 연결을 끊거나, 앱을 나가거나, 터미널을 닫으면 터미널이 폰 크기로 폰에 돌아옵니다.

설정 → 모양 → 외부 디스플레이에서 끄거나, 폰에 무엇을 보일지 고르거나, 거기에 쓸 글자 크기를 정합니다(기본 17).

블루투스 키보드를 함께 쓰면 폰을 아예 내려놓아도 됩니다. 키는 터미널로 바로 가고 앱 단축키만 키맵이 가져갑니다. 세션을 오갈 때 쓰는 Alt+` 전환기는 큰 화면 쪽에 그려집니다.

Chromecast와 Google TV 화면 전송은 디스플레이를 더하지 않고 폰 화면을 그대로 비추므로 터미널이 폰 크기로 보입니다. 삼성 DeX를 켜면 앱이 모니터에서 바로 실행됩니다.

알림과 라이브 액티비티

컴퓨터에서 에이전트 훅을 설치해 두면 폰이 에이전트의 상태를 압니다 — 일하는 중인지, 권한을 기다리는지, 끝났는지.

Live Update는 계정에 하나입니다. 머신마다 따로 뜨지 않고 알림 하나에 머신별 한 줄로 모입니다. 계정이 바빠질 때 시작하고, 시계는 가장 오래 일하는 턴부터 흐르며, 일하거나 기다리는 것이 없으면 "모두 끝남"을 보여 주고, 10분간 조용하면 닫힙니다. iPhone의 라이브 액티비티와 같은 내용을 같은 규칙으로 그립니다. 온라인인 머신만 셉니다.

거기 실리는 것은 이름과 상태와 개수와 시각뿐입니다. 터미널 내용은 실리지 않습니다.

기다리는 프롬프트는 선택지를 알림의 버튼으로 보여 주고 이 버튼은 폰 잠금을 풀어야 눌립니다. 알림을 누르면 그 세션이 열립니다.

Claude Code가 질문 여러 개를 한 번에 물으면(AskUserQuestion) 시트가 한 단계씩 넘어가고, 여러 개를 고르는 질문은 체크박스로 보이며 답 보내기가 한꺼번에 보냅니다. 입력은 st가 대신 칩니다. 알림의 답 버튼은 질문 하나, 답 하나일 때만 나옵니다.

에이전트가 턴을 서브에이전트에게 넘기면 세션은 끝남이 아니라 서브에이전트 작업 중 (3)으로 나오고, 조용한 알림이 열기 버튼과 함께 그렇게 알려 줍니다.

알림 설정. 설정 → 알림 → 에이전트 알림 한 줄에 켜짐·꺼짐과 안 읽은 수가 나오고, 누르면 알림 기록, 알림·오프라인·Live Update, 결정 게이트만 알림, 작업 완료·시작 알림, 방해 금지 시간, 머신별 스위치가 묶음으로 나뉜 화면이 열립니다.

알림 기록

터미널을 뺀 모든 화면 위의 종 아이콘(또는 설정 → 알림 → 에이전트 알림 → 알림 기록)에서 폰이 받은 알림을 최신순으로 다시 볼 수 있고, 안 읽은 수가 함께 보입니다. 누르면 그 알림이 열리고, 오른쪽으로 밀면 읽음, 왼쪽으로 밀면 삭제, 모두 읽음으로 한 번에 읽을 수 있습니다. 읽은 알림은 안 읽음 목록과 알림 창, 런처 배지에서 사라지고, 같은 계정으로 로그인한 다른 기기에서도 사라집니다. 컴퓨터에서 질문에 답하거나 머신이 다시 온라인이 되면 그 알림은 저절로 읽음이 됩니다.

에이전트가 일하는 동안 떠 있는 진행 알림은 그대로 두고, 읽은 알림만 내립니다.

머신 상태와 AI 사용량

머신 목록 맨 아래에 작은 줄이 두 개 있습니다. 전체 머신 지표는 온라인 머신 수와, 문제가 있는 머신이 있으면 그 가장 나쁜 수치("온라인 3대 · 1대 ⚠ 스왑 94%", 주황이나 빨강)를 보여 주고, 누르면 개요가 열립니다. 계정의 모든 머신의 지난 10분 메모리, 스왑, CPU가 가장 빠듯한 머신부터 나옵니다. 오프라인 머신은 세지 않습니다. AI 사용량은 Claude와 Codex 계정마다 5시간·주간 사용량("Claude · 5시간 42% · 주간 61%")을 보여 주고 AI 사용량 화면을 엽니다. AI 사용량과 지난 세션을 보세요.

문제가 있는 머신은 그 머신이 있는 곳에서 알려 줍니다. 머신 목록의 이름 아래와 그 머신의 세션 화면에 가장 나쁜 수치가 스왑 94%, 메모리 91%처럼 주황 삼각형(경고)이나 빨간 팔각형(위험)과 함께 나옵니다. 괜찮은 머신에는 아무것도 없습니다. 누르면 그 머신의 지표가 열립니다.

설정 → 알림 → 머신 상태 표시에서 무엇을 보일지 고릅니다.

• 표시: 끄기, 위험만, 경고와 위험(기본).
• 기준: 메모리 사용(90% / 96%), 스왑 사용(75% / 92%), 켜면 CPU까지. 기본값은 st가 쓰는 것과 같고 기본값으로 되돌리기로 돌아갑니다. st가 오래돼 숫자를 보내지 않는 머신은 st가 매긴 상태를 따릅니다.
• 머신: 머신을 끄면 그 머신의 상태를 숨깁니다. 스왑을 늘 많이 쓰는 Mac 같은 경우에 씁니다. 그 머신의 지표 화면에서, 또는 개요에서 카드를 길게 눌러도 됩니다.

머신의 지표와 개요의 그래프에는 기준이 점선으로(경고는 주황, 위험은 빨강) 그려지고, 거기의 기준을 누르면 같은 편집기가 열립니다. 그 머신의 스위치가 맨 위에 있습니다.

이 설정은 행에 보이는 것만 바꿉니다. 개요에는 늘 st가 매긴 모든 머신의 상태가 나옵니다.

문서와 pane으로 공유

머신 화면. 머신의 세션이 하나씩 카드로 먼저 보입니다. 그 위에 칩이 한 줄 있고 다 들어가지 않으면 옆으로 밉니다. 맨 앞은 그 머신의 st에 새 버전이 있을 때의 st 업데이트입니다. 문서에는 그 머신의 문서 수와 마지막으로 연 뒤에 새로 온 수가, 지표에는 "메모리 62%" 같은 값 하나가 나오고, 머신에 문제가 있으면 주황이나 빨강에 경고 표시가 붙습니다. AI 사용량에는 그 머신의 에이전트가 쓰는 계정 중 가장 찬 한도가 "Claude 61% 주간"처럼 나옵니다. ⑂ N은 그 머신의 에이전트가 다른 에이전트에게 일을 맡기고 있을 때 나오고 에이전트 차트를 엽니다. 기록은 지난 에이전트 세션을 엽니다. ⚠ 훅은 훅을 살펴볼 일이 있을 때만 나옵니다. 칩을 누르면 그 화면이나 시트가 열립니다. 세션의 윈도우 목록에서도 윈도우마다 카드이고, 그 안에서 실행 중인 것(에이전트, 서브에이전트, 팀원)은 윈도우 번호 아래로 내려오는 가는 선에 매달려 있습니다. 머신이 오프라인이면 줄에 오프라인이 나오고, 문서는 이 폰에 저장해 둔 그 머신의 문서를 엽니다.

머신의 문서. 문서를 지원하는 st(0.3.43 이상)가 실행 중인 머신에는 화면 맨 위에 문서 칩이 있습니다. 에이전트가 st doc으로 넘긴 문서가 최신순으로 있습니다. 열면 렌더링 또는 원문으로 읽고, 전체 복사로 markdown을 복사하고, 공유로 실제 .md 파일을 보내고, 이 기기에 저장으로 문서 탭에 두고(어느 폴더에 둘지 묻고, 머신 이름 폴더가 먼저 나옵니다), Download/sophonz로 내보내기로 기기의 다운로드 폴더에 사본을 만들고, Compose로 보내기로 pane의 Compose에 넣습니다. 목록의 ⋮에 모두 이 기기에 저장이 있습니다. 새 문서 알림을 누르면 그 문서가 열립니다.

편집. 편집한 뒤 둘 중 하나로 저장합니다.

• PC에 저장은 고친 내용을 머신의 문서에 씁니다(st 0.3.46 이상). st가 ~/.sophonz/docs에 가진 사본만 바뀌고, 에이전트가 넘긴 원래 파일은 그대로입니다. 편집하는 사이 그 문서가 바뀌었으면(웹 터미널이나 다른 기기에서) 덮어쓰기, 둘 다 유지(내 것은 Plan이면 "Plan (수정본)"이라는 새 문서로), 취소(계속 편집) 중에서 고릅니다. 머신이 오프라인이면 버튼이 꺼지고 이유를 보여 줍니다.
• 이 기기에 저장은 머신이 있든 없든 문서 탭에 둡니다.

문서 탭. 이 기기에 저장한 것만 보여 주고, 머신이 꺼져 있어도 읽힙니다. 앱 전용 저장소의 폴더 안의 폴더에 평범한 .md 파일로 있고, Download/sophonz로 내보내기로 다른 앱(Obsidian도)이 열 수 있는 곳에 사본을 만듭니다. 제목과 내용 검색, 최근 수정 · 이름 · 작성 날짜 정렬, 문서와 폴더 만들기 · 이름 바꾸기 · 이동 · 삭제(행을 길게 누르기). 머신에서 저장한 파일에는 PC에 저장도 있고, 그 뒤 머신의 문서가 바뀌었으면 work-mac에 새 버전이 있습니다(머신 이름으로)와 업데이트, 이대로 두기가 나옵니다. 어디서 왔는지는 파일 옆에 따로 두고 파일 안에는 쓰지 않습니다. 예전 버전에서 고친 사본도 그대로 있습니다.

문서 탭이나 머신의 문서를 처음 열면 짧은 안내가 나오고, 이 화면들의 ?로 다시 엽니다. 문서를 보세요.

pane으로 공유. 어느 앱에서든 텍스트, 링크, .txt/.md 파일을 sophonz로 공유하고 머신, 세션, 윈도우, pane을 고릅니다(최근에 쓴 곳이 먼저). 그 pane에서 터미널이 열리고 내용은 보내지 않은 채로 Compose에 들어갑니다. 머신 링크는 전처럼 머신 추가로 갑니다. 초안은 보낼 때까지 pane마다 남습니다. 사진과 PDF도 같은 방법으로 공유할 수 있습니다. 그 머신에 올라가고 경로가 초안에 들어갑니다(st 0.3.58부터).

Compose의 불러오기는 머신의 문서, 문서 탭의 문서, .md/.txt 파일을 커서 위치에 넣습니다. 터미널에서 선택을 복사하면 .md로 저장이 나오고(선택 메뉴에도 있습니다), 문서 탭과 Download/sophonz에 들어갑니다.

위젯

홈 화면의 빈 곳을 길게 누르고 위젯에서 sophonz → 에이전트를 원하는 곳으로 끌어 놓습니다. 처음에는 2×2이고, 위젯을 길게 누른 뒤 가장자리를 끌면 커집니다.

놓을 때 모양을 고릅니다. 앱과 같게(기본. 앱 테마를 바꾸지 않았다면 앱처럼 검정), 다크, 라이트, 시스템(폰의 라이트·다크 모드와 배경화면 색). Android 12 이상에서는 위젯을 길게 누르고 연필을 누르면 다시 바꿀 수 있습니다.

위젯을 누르면 알림을 누를 때처럼 보이던 것이 열립니다. 기다리는 에이전트면 그 결정 화면, 아니면 그 세션입니다. 중간과 큰 위젯은 누른 줄이 열립니다.

위젯은 계정이 있어야 하고 라이브 업데이트처럼 이름과 상태만 보여 줍니다. 위젯이 머신에 직접 연결하지는 않습니다. 에이전트 알림과 라이브 업데이트가 올 때마다 바뀌고, 앱이 머신 목록을 불러올 때도 바뀝니다. 소식이 없으면 30분마다 목록을 확인합니다. 크기마다 3분 전 업데이트처럼 얼마나 지난 정보인지 쓰고, 15분이 넘으면 흐려집니다. 알림을 끄면 앱과 30분 확인만 위젯을 새로 고칩니다. 위젯의 글자는 폰의 언어를 따릅니다.

터미널

두 번째 위젯은 세션으로 바로 들어갑니다. 같은 방법으로 sophonz → 터미널을 홈 화면에 끌어 놓고, 에이전트 위젯처럼 크기를 바꿉니다.

열린 세션을 마지막에 쓴 것부터 보여 줍니다. 이 폰에서 마지막으로 연 세션, 또는 에이전트가 마지막으로 바뀐 세션입니다. 줄마다 세션 이름, 머신, 창 수와 보고 있는 기기 수, 에이전트가 있으면 색 점(에이전트 위젯과 같은 색)이 있습니다. 작은 위젯은 마지막에 쓴 세션 하나를 크게, 중간은 4개까지, 큰 위젯은 머신별로 묶어 보여 줍니다. 오프라인 머신은 흐리게, 마지막에 있던 세션을 그대로 보여 줍니다.

세션을 누르면 그 터미널이 열립니다. 모양은 에이전트 위젯처럼 고릅니다. 목록은 앱과 30분 확인이 불러오고, 에이전트 점은 에이전트 알림이 올 때 에이전트 위젯과 함께 바뀝니다.

머신의 st 업데이트

머신의 st에 새 버전이 있으면 그 머신의 줄과 화면에 업데이트 있음이 나옵니다. 머신 화면의 st 업데이트 칩은 "st와 에이전트 훅"을 엽니다. 거기서 st 업데이트를 누르면 먼저 묻고, 그 머신의 st가 스스로 업데이트합니다(st upgrade와 같은 내려받기, 점검, 인계). 앱은 단계마다 보여 줍니다. 링크는 그대로이고 세션도 계속 실행됩니다. 새 버전이 뜨지 않으면 지금 버전이 돌아오고 앱이 이유를 알려 줍니다. 그 머신의 st가 스스로 업데이트할 수 없으면(Homebrew로 설치했거나, ST_VERSION으로 버전을 고정했거나, 개발 빌드) 시트에 여기서는 업데이트할 수 없음과 그 머신에서 실행할 명령이 나옵니다(Homebrew면 brew upgrade st 후 st restart).

에이전트 훅이 오래됐거나 일부만 있으면 머신 화면에 ⚠ 훅 칩(같은 시트의 설치)이, 그 에이전트가 실행 중인 터미널에는 설치 띠가 나옵니다. 터미널에는 아무것도 입력하지 않습니다. 설치한 뒤에는 에이전트를 다시 시작하거나 Claude Code에서 /hooks를 여세요. 에이전트 훅을 보세요.

계정

로그인하면 계정에 등록된 머신이 동기화됩니다. 설정 → 계정 → sophonz로 로그인을 누르면 앱의 로그인 화면이 나옵니다. 이메일과 비밀번호를 넣고 로그인을 누릅니다. 자동 완성이 채워 주고, 로그인하면 폰이 비밀번호 저장을 묻습니다. 계정 만들기와 비밀번호를 잊으셨나요?는 앱 위에 브라우저 탭으로 sophonz 페이지를 열고, 끝나면 앱으로 저절로 돌아옵니다. 다른 로그인 방법(GitHub, Google) 버튼은 켜지면 나타납니다. 그러면 머신 탭에 계정 이메일 아래로 계정의 머신이 나오고, 누르면 링크 없이 세션이 열립니다. 링크와 QR은 로그인과 상관없이 계속 됩니다. 계정의 머신에 호스트 이름 말고 다른 이름을 붙이려면 머신 이름 바꾸기를 보세요.

PRO 요금제 계정에는 설정의 계정 아바타에 PRO 표시가 붙습니다. Free 요금제는 먼저 추가한 머신 3대까지 쓰고, 넘는 머신은 줄에 요금제 한도로 중지됨이 나옵니다.

온라인인 계정 머신 아래에는 세션도 함께 나옵니다. 세션은 머신 카드 안에 한 칸 들어가 터미널 아이콘과 함께 있습니다. 세션 줄 끝의 눈 아이콘과 숫자는 지금 그 세션을 보고 있는 기기 수입니다(이 폰, 브라우저, 컴퓨터의 터미널). 머신 행의 화살표를 누르면 세션을 접고, 폰이 머신마다 기억합니다. 접힌 머신도 이름 아래에 가장 급한 에이전트 상태와 세션 수를 보여 줍니다. 행을 누르면 접혀 있든 아니든 머신이 열립니다.

머신이나 세션 링크 공유

머신 메뉴(머신 행이나 세션 목록 위의 ⋮), 세션 메뉴(세션 행을 길게 누르기, 창 목록 위의 ⋮), 터미널의 ⋮에 링크 복사, 공유…, 브라우저에서 열기가 있습니다. 셋 다 같은 링크를 씁니다.

• 계정의 머신: https://link.sophonz.io/m/<slug>(st가 계정에서 받은 slug), 세션이면 뒤에 /s/<세션>. 이 링크는 열쇠가 아닙니다. 로그인한 본인에게만 열리고, 링크를 받은 다른 사람은 로그인을 요구받을 뿐 아무것도 보지 못합니다.
• 계정 없이 링크로 추가한 머신: 터널 주소. ?k= 토큰은 빠지고, 열면 토큰을 묻습니다. 그 st가 토큰 없이 실행 중이면 주소만으로 터미널이 열리므로, 그런 링크를 처음 공유할 때 앱이 먼저 이 링크가 있으면 누구나 이 터미널을 쓸 수 있어요라고 알립니다.

공유…는 Android 공유 시트(Quick Share, 메신저, 메일)를 엽니다. 브라우저에서 열기는 링크를 브라우저로 넘겨, 웹 터미널이 자기 탭에 열린 채로 남습니다.

설정

설정은 여섯 묶음이고 이름과 순서는 iPhone과 같습니다: 계정, 알림, 모양, 키와 입력, 사용량, 가이드와 정보. 줄마다 자기 화면이 열립니다. 계정 삭제는 맨 아래에 따로 있습니다. 안쪽 화면의 몇몇 항목(Theme, Layout, Haptics 등)은 앱에서 아직 영어로 나오므로 여기서도 그대로 적습니다.