iPhone

st 설치부터 폰 속 터미널까지, 한 단계씩.

앱을 처음 열면 빈 머신 탭이 나옵니다. 무엇부터 해야 하는지와 설치 명령이 그 화면에 있어서 거기서 바로 복사할 수 있습니다.

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

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. 머신 추가

QR 스캔을 눌러 터미널의 코드를 카메라로 찍거나, 링크를 복사한 뒤 링크 붙여넣기를 누릅니다. 위쪽 +도 같은 시트를 여는데, 방법은 셋입니다.

• QR 스캔 — st가 띄운 코드.
• 링크 붙여넣기 — ?k=가 붙은 링크, 또는 계정의 고정 link.sophonz.io 링크.
• 직접 입력 — 터널 주소와 토큰을 따로 입력.

이름은 넣고 싶으면 넣고, 추가를 누릅니다.

3. 세션 고르기

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

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

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

4. 터미널

위쪽 막대의 알약에 지금 보고 있는 머신, 세션, 창이 표시됩니다. 알약을 누르면 세션, 창, pane을 고르는 시트가 열리고, 길게 누르면 지금 창의 이름을 바꿉니다. 맨 오른쪽 버튼은 메뉴입니다.

키바

키보드 위에 붙어 있고, 키보드를 내려도 화면 아래에 남아 있습니다.

멀티플렉서 줄은 앱이 다룰 수 있는 멀티플렉서가 그 머신에서 실행 중일 때만 나타납니다. 키를 길게 누르면 무엇을 보내는지 보여 줍니다. 줄과 키는 설정 → 키와 입력 → 키 바 → 배치나 키맵 파일로 바꿀 수 있습니다 — 키바 참고.

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

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

음성

마이크 키를 누른 채로 말하고, 떼면 보내집니다. 짧게 탭하면 손을 떼고 말하는 모드가 되고, 한 번 더 탭하면 보냅니다. 듣는 동안 뜨는 말풍선에 인식된 내용이 보이고, 여기서 모드를 바꿀 수 있습니다.

• Chat — 말한 내용을 입력하고 Enter까지 누릅니다. 에이전트에게 말할 때.
• Command — 입력만 합니다. 확인한 뒤 직접 Enter를 누를 때.

iOS가 그 언어를 기기 안에서 인식할 수 있으면 음성은 폰 밖으로 나가지 않습니다.

작성

연필 키를 누르면 긴 프롬프트를 쓰는 시트가 열립니다. 여러 줄을 쓰고 보내기를 누르면 한 메시지로 들어갑니다. 줄바꿈은 Alt+Enter로, 마지막만 Enter로 보내므로 에이전트가 첫 줄에서 바로 움직이지 않습니다. 입력칸 아래 버튼은 아이콘이고 Android와 같은 여섯 개입니다.

VoiceOver는 버튼마다 이름과 하는 일을 읽어 줍니다.

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

선택과 복사

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

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

창

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

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

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

창 안에서 실행 중인 것

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

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

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

코디네이터와 워커

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

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

iPhone 앱 0.1.93 이상에 있고, 오케스트레이션을 실행하는 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 확대), iPad에서는 창의 나머지와 함께 열립니다. 설정 › 모양 › 터미널 › Pane › pane을 확대해서 열기로 바꿉니다. 창 전체 열기는 창을 그대로 엽니다.

터미널에서 다른 pane으로 옮기려면 알약 시트에서 나뉜 창 아래의 pane을 누르거나, 메뉴의 Pane으로 같은 지도를 엽니다. 앱이 한 확대는 터미널을 나가거나 다른 창으로 갈 때 되돌리므로, 컴퓨터 앞의 사람이 확대된 창을 보게 되지 않습니다. 원래 확대돼 있던 창과 키 바의 zoom으로 직접 한 확대는 그대로 둡니다. VoiceOver는 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. 다음부터는

머신은 저장됩니다. 머신 탭에 마지막으로 연결된 시각과 함께 남고, 한 번 누르면 바로 세션 목록으로 갑니다.

머신이 온라인이 아닐 때

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

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

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

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

연결 점검(머신 탭에서 머신을 길게 누르거나, 머신 화면의 ••• 메뉴, 터미널 ••• 메뉴)은 sophonz, 머신 하트비트, 터널 주소, st, 실시간 연결, 지연 시간을 차례로 확인하고 어디서 응답이 끊기는지, 무엇을 하면 되는지 알려 줍니다. 결과 복사는 주소나 키 없이 결과를 복사합니다. st 0.3.62 이상이 필요합니다.

큰 화면으로

AirPlay로 별도 디스플레이를 띄우거나 케이블로 연결하면, 열려 있던 터미널이 그 화면을 가득 채웁니다. 폰 화면을 복사하는 것이 아니라 글자가 그 화면 크기대로 그려집니다.

폰은 그동안 입력하는 기기로 남습니다. 키바, 키보드, Compose, 제스처가 그대로 있고, 지금 큰 화면에 무엇이 떠 있는지 작은 미리보기 카드로 보여 줍니다.

크기에 관해 하나: 연결된 동안 창 크기는 큰 화면의 것입니다. 연결을 끊으면 창이 폰 크기로 돌아오고, 큰 화면에서 짜 둔 레이아웃은 무너지지 않습니다.

설정 → 모양 → 외부 디스플레이에서 끄거나, 거기에 쓸 글자 크기를 따로 정합니다.

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

알림과 라이브 액티비티

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

라이브 액티비티는 계정에 하나입니다. 머신마다 따로 뜨지 않고, sophonz 마크 아래 한 장에 머신별로 한 줄씩 모입니다. 작업 중인 세션의 턴 시간이 카드에서 저절로 흐릅니다. 계정이 바빠질 때 시작하고, 일하거나 기다리는 것이 없으면 "모두 끝남"을 보여 주고 다시 일이 생기면 같은 카드가 이어지며, 10분간 조용하면 닫힙니다. 온라인인 머신만 셉니다.

거기 실리는 것은 이름과 상태와 개수와 시각뿐입니다. 터미널 내용은 실리지 않습니다 — 잠금화면의 실시간 상태는 평문으로 Apple과 우리 서버를 지나가기 때문입니다.

기다리는 프롬프트는 선택지를 알림의 버튼으로 보여 주고, 잠금화면에서 답하려면 폰 잠금을 풀어야 합니다. 알림이나 알림의 열기를 누르면 그 세션의 창으로 갑니다.

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

에이전트가 턴을 서브에이전트에게 넘기면 세션은 끝남이 아니라 서브에이전트 작업 중 (3), 자리가 좁으면 서브에이전트 · 3으로 나옵니다.

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

알림 기록

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

머신 상태와 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은 그 머신의 에이전트가 다른 에이전트에게 일을 맡기고 있을 때 나오고 에이전트 차트를 엽니다. ⚠ 훅은 훅을 살펴볼 일이 있을 때만 나옵니다. 칩을 누르면 그 화면이나 시트가 열립니다. 지난 에이전트 세션은 새 세션 카드의 지난 세션 이어 하기에서 엽니다. 세션의 윈도우 목록에서도 윈도우마다 카드이고, 그 안에서 실행 중인 것(에이전트, 서브에이전트, 팀원)은 윈도우 번호 아래로 내려오는 가는 선에 매달려 있습니다. 머신이 오프라인이면 줄에 오프라인이 나오고, 문서는 이 iPhone에 저장해 둔 그 머신의 문서를 엽니다.

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

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

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

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

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

pane으로 공유. 어느 앱에서든 공유 시트에서 sophonz를 고르고 텍스트, 링크, .txt/.md 파일을 보낸 뒤 머신, 세션, 윈도우, pane을 고릅니다(최근에 쓴 곳이 먼저). 보내지 않은 채로 그 pane의 Compose에 들어가고, Compose에 준비됨 — 눌러서 열기 알림이 그리로 데려갑니다. 초안은 보낼 때까지 pane마다 남습니다. 사진과 PDF도 같은 방법으로 공유할 수 있습니다. 그 머신에 올라가고 경로가 초안에 들어갑니다(st 0.3.58부터).

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

위젯

홈 화면이나 잠금화면을 길게 누르고 편집 → 위젯 추가에서 sophonz → 머신의 에이전트를 고릅니다.

그림에서 아래쪽이 에이전트 위젯입니다.

• 맨 위는 계정 전체입니다. 응답을 기다리는 에이전트 대기 1, 일하는 에이전트 작업 1, 띄운 서브에이전트 중 아직 실행 중인 수 서브 3/3, 그리고 지금 바로 새로 읽는 ↻. 이름 아래 방금 업데이트는 얼마나 지난 내용인지입니다.
• 한 줄이 머신 하나입니다. 점은 그 머신의 가장 급한 상태이고, 그 옆이 가장 급한 세션과 하는 일(api · 응답 대기)이며, +1은 세션이 하나 더 있다는 뜻입니다. 오른쪽은 그 머신의 수이고, 메모리가 부족하면 **⚠**가 붙습니다(위험하면 빨간색).
• 에이전트 없음은 온라인이지만 실행 중인 에이전트가 없는 머신이고, 머신 1대 더는 나머지 머신입니다.

위쪽 터미널은 두 번째 위젯입니다.

작은 위젯은 StandBy에서도 보입니다. 위젯 편집에서 머신 하나를 고를 수 있고, 비워 두면 계정 전체입니다.

홈 화면 위젯은 맨 위에 sophonz 마크와 에이전트가 있습니다. 위젯은 앱처럼 어둡습니다. 앱의 설정 → 모양 → 테마와 글꼴 → 테마를 따르므로 홈 화면이 라이트여도 어둡게 보입니다. 위젯 편집 → 모양에서 위젯마다 앱 설정 따르기 대신 다크, 라이트, 시스템을 고를 수 있습니다. 틴트·투명 홈 화면과 잠금화면에서는 시스템이 색을 칠합니다.

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

위젯은 계정이 있어야 하고 라이브 액티비티처럼 이름과 상태만 보여 줍니다. 위젯이 머신에 직접 연결하지는 않습니다. 에이전트 알림이 올 때, 앱이 머신 목록을 불러올 때, 가끔은 백그라운드에서 위젯이 새로 고쳐집니다. iOS 26에서는 에이전트가 바뀔 때 계정 쪽에서 위젯을 깨우고, 위젯은 이름과 상태만 읽을 수 있는 자기 전용 키로 최신 상태를 읽습니다. 크기마다 3분 전 업데이트처럼 얼마나 지난 정보인지 쓰고, 15분이 넘으면 흐려집니다. 맨 위의 ↻를 누르면 최신 이름과 상태를 바로 읽습니다. 계정 쪽이 아직 지원하지 않으면 위젯이 그렇게 알려 주고 폰에 있는 정보를 보여 줍니다. 알림을 끄면 앱만 위젯을 새로 고칩니다.

실시간으로 보려면 라이브 액티비티를 쓰세요. 위젯은 에이전트가 응답을 기다리거나 오류가 나거나 머신이 오프라인이 될 때는 바로, 그 밖의 변화는 1분쯤 모아서 다시 그립니다. 에이전트 알림이 올 때마다 그 세션만이 아니라 계정 전체가 맞춰집니다. 위젯의 글자는 폰의 언어를 따릅니다.

터미널

두 번째 위젯은 세션으로 바로 들어갑니다. 같은 방법으로 sophonz → 터미널을 홈 화면(작은, 중간, 큰)이나 잠금화면(직사각형)에 놓습니다.

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

세션을 누르면 그 터미널이 열립니다. 위젯 편집 → 모양은 에이전트 위젯과 같습니다. 목록은 앱이 불러온 것이라, 방금 만든 세션은 앱을 열면 나타납니다. 에이전트 점은 에이전트 알림이 올 때 에이전트 위젯과 함께 바뀝니다.

머신의 st 업데이트

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

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

계정

로그인하면 계정에 등록된 머신이 동기화됩니다. 설정 → 계정 → sophonz로 로그인을 누르면 앱의 로그인 화면이 나옵니다. 이메일과 비밀번호를 넣고 로그인을 누릅니다. 암호 자동 완성이 채워 줍니다. 계정 만들기와 비밀번호를 잊으셨나요?는 iOS 로그인 시트에 sophonz 페이지를 열고, 끝나면 시트가 저절로 닫힙니다. 다른 로그인 방법 버튼은 켜지면 나타납니다. 그러면 머신 탭에 계정에 등록된 머신도 함께 나오고, 누르면 링크를 붙여넣을 필요 없이 세션이 열립니다. 링크와 QR은 로그인과 상관없이 계속 됩니다. 계정의 머신에 호스트 이름 말고 다른 이름을 붙이려면 머신 이름 바꾸기를 보세요.

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

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

설정

설정은 여섯 묶음이고 이름과 순서는 Android와 같습니다: 계정, 알림, 모양, 키와 입력, 사용량, 가이드와 정보. 줄마다 자기 화면이 열립니다. 계정 삭제는 맨 아래에 따로 있습니다.