문서

st doc — 에이전트가 쓴 문서를 폰, 태블릿, 웹 터미널로. 장치에 남고, 내 링크로 읽고, 앱에서 고칩니다.

에이전트가 계획, 요약, 릴리스 노트를 씁니다. st doc은 그 문서를 스크롤백에 두지 않고 폰이나 태블릿으로 보냅니다.

st doc notes.md                    # .md 또는 .txt, 1 MB까지
cat plan.md | st doc --title Plan  # 파이프로
st doc ls                          # 이 장치가 가진 문서

st의 tmux 안에서 실행하면 어느 세션, 창, pane에서 왔는지와 그 pane의 에이전트를 같이 적습니다. 앱에 "📄 Plan" / "from work · claude" 알림이 오고, 문서는 장치의 문서에 있습니다.

폴더

머신의 문서는 폴더에 넣을 수 있습니다(st 0.3.86 이상). 폴더는 디스크의 디렉터리가 아니라 문서마다 붙는 경로(plans/2026)라서, 폴더를 모르는 옛 앱과 st도 모든 문서를 지금처럼 봅니다. 폴더가 없는 문서는 맨 위에 있습니다.

st doc notes.md --folder plans     # 폴더에
st doc ls --tree                   # 폴더 나무로
st doc mv Plan plans/2026          # 옮기기("/"는 맨 위), --title로 이름도
st doc mkdir ideas                 # 빈 폴더
st doc mvdir ideas notes/ideas     # 폴더 이름 바꾸기·옮기기
st doc rmdir notes/ideas           # 빈 폴더 지우기

웹 터미널과 데스크탑 앱은 문서를 Obsidian처럼 그립니다. [[제목]] 링크와 ![[제목]] 넣기, 콜아웃(> [!note]), 맨 위 YAML 속성, #태그, ==강조==, 개요와 백링크가 있습니다.

에이전트에게 알려 주기

CLAUDE.md(또는 AGENTS.md)에 넣으세요.

## Documents for my devices
 
When you write a document meant for me to read (a plan, a summary, release
notes, a report), save it as a .md file and run `st doc <file>` so it reaches
my phone or tablet. Use `--title` for a short title. Do not use it for code
changes or logs.

앱에서 바로 말하기

빠른 프롬프트가 대신 말해 줍니다. Compose, 터미널 메뉴(iPhone은 •••, Android는 ⋮), 에이전트 줄의 prompt 키에 있고, 누르면 그 pane의 에이전트에게 보냅니다.

폰으로 문서 보내기: "방금 내용을 마크다운 문서로 정리해서 st doc으로 내 폰에 보내 줘 (짧은 제목을 붙여서)."
계획을 문서로: "계획을 마크다운 문서로 작성해서 st doc으로 보내 줘."
작업 요약을 문서로: "지금까지 작업을 요약해서 마크다운 문서로 st doc으로 보내 줘."

문장마다 st doc이 그 장치의 셸 명령이라는 것과 실행하는 법(st doc <파일> --title "...", 또는 파이프)을 덧붙입니다. 영어 문장도 같은 목록에 있습니다. 보내기 전에 고치려면 Android는 터미널 메뉴에서 길게 누르고, iPhone은 고쳐서 보내기를 쓰면 Compose가 그 글로 열립니다. 설정 › 빠른 프롬프트에서 추가, 순서 바꾸기, 기본값으로 되돌리기를 합니다. 기기마다 따로 저장됩니다.

저장 위치

장치의 ~/.sophonz/docs에, 지울 때까지. 기간이 지나 사라지는 일은 없습니다. 없애는 길은 삭제뿐이고, 앱과 웹 터미널 양쪽에 있으며 한 번 더 묻습니다.
st가 가진 것은 사본입니다. st doc notes.md는 notes.md를 한 번 읽을 뿐이고 앱이나 웹 터미널에서 고쳐 저장하면 st의 사본만 바뀌며 notes.md는 그대로입니다.
~/.sophonz/outbox/에 넣은 파일도 같은 방법으로 들어갑니다. st가 실행 중이지 않을 때 st doc이 문서를 두는 곳도 여기이고, st가 뜨면 나갑니다.
본문은 sophonz 서버를 지나지 않습니다. 앱은 터미널처럼 내 장치의 링크로 읽습니다. 알림에는 제목만, 내 기기의 키로 암호화해서 실립니다.

폴더와 링크

st 0.3.86부터는 장치가 문서를 폴더로 나눠 보관하고, 문서끼리 Obsidian처럼 서로 링크합니다.

st doc plan.md --folder work/auth    # 폴더에 넣기 (st doc add plan.md도 같음)
st doc ls --tree                     # 모든 폴더와 그 안의 문서
st doc ls work                       # 한 폴더만
st doc mv Plan work/done             # 옮기기 ("/"는 맨 위), --title로 이름 바꾸기
st doc mkdir ideas                   # 폴더 만들기, 비어 있어도 남음
st doc mvdir work/auth archive/auth  # 폴더를 안의 문서째 이름 바꾸거나 옮기기
st doc rmdir ideas                   # 빈 폴더 지우기

st doc mv에서는 문서를 id, 제목, 폴더/제목 중 하나로 지정합니다. 본문의 [[Title]], [[folder/Title]], [[Title#Heading|text]]는 다른 문서로 가는 링크이고, ![[Title]]은 다른 문서를 그 자리에 넣어 보여 줍니다.

앱에서

장치 아래 문서: 최신순. 열면 렌더링 또는 원문 markdown으로 읽고, 전체 복사, .md 파일로 공유, 이 기기에 저장(어느 폴더에 둘지 묻고, 장치 이름 폴더가 먼저)할 수 있습니다. 모두 이 기기에 저장은 전부를 한 번에 저장합니다.
파일 이름은 <세션>-<에이전트>-<날짜>-<시각>-<제목>.md입니다.
문서 탭을 처음 열 때와 장치의 문서를 처음 열 때 짧은 안내가 나옵니다. 이 기기의 문서, 장치의 문서와 두 가지 저장, 문서가 오는 방법, 에이전트와 함께 쓰기(CLAUDE.md 문단과 "인증 마이그레이션 계획을 .md 파일로 쓰고 st doc으로 내 폰에 보내 줘." 같은 예시 요청, 각각 복사 버튼) 순서입니다. 그 화면들과 문서 화면의 ?로 다시 엽니다. 목록이 비어 있으면 보내는 방법을 보여 줍니다.
편집한 뒤 PC에 저장(st 0.3.46 이상)으로 장치의 문서를 바꾸거나, 이 기기에 저장으로 내 버전을 앱에 둡니다. 편집하는 사이 장치의 문서가 바뀌었으면 덮어쓰기, 둘 다 유지(내 것은 새 문서로), 취소 중에서 고릅니다. 장치가 오프라인이면 PC에 저장이 꺼지고 이유를 보여 줍니다.
Compose로 보내기는 pane에 입력하는 칸에 넣고, Compose의 불러오기는 문서 (장치, 문서 탭, 파일)를 쓰던 글에 넣습니다.
삭제는 장치에서 문서를 없앱니다. iPhone과 iPad는 행을 밀고, Android는 휴지통을 누릅니다. 양쪽 다 한 번 더 묻습니다. 기기에 저장하거나 공유한 사본은 그대로입니다.

문서 탭

앱의 문서 탭에는 그 기기에 저장한 것만 있고, 장치가 꺼져 있어도 읽힙니다. 지하철에서도, 컴퓨터가 잠들어 있어도요.

폴더 안의 폴더에 평범한 .md 파일로 있습니다. iPhone과 iPad에서는 파일 앱의 나의 iPhone(또는 나의 iPad) › sophonz에 보이는 그 파일이라 Obsidian 같은 앱으로도 열리고, Android에서는 앱 저장소에 있으며 내보내기로 Download/sophonz에 사본을 만듭니다.
제목과 내용 검색, 최근 수정 · 이름 · 작성 날짜 정렬, 문서와 폴더 만들기 · 이름 바꾸기 · 이동 · 삭제.
장치에서 저장한 파일은 어느 문서에서 왔는지 기억합니다(파일 안이 아니라 옆에). 장치의 문서가 더 새로우면 work-mac에 새 버전이 있습니다(장치 이름으로)가 나오고 업데이트나 이대로 두기를 고릅니다. 여기서도 PC에 저장이 됩니다.

웹 터미널과 데스크탑 앱에서

데스크탑 레이아웃에서는 사이드바의 장치 아래에 있는 Documents로, 폰에서는 하단 네비의 docs로 문서를 엽니다. st 0.3.86 이상이면 Obsidian 볼트처럼 볼 수 있습니다.

폴더는 왼쪽에 트리로 나오고, new, folder, upload와 필터가 함께 있습니다(필터에서 Enter를 누르면 본문까지 찾습니다). 문서나 폴더를 다른 폴더로 끌어다 놓으면 옮겨지고, .md 파일을 패널에 끌어다 놓으면 올라갑니다.
문서에서는 [[링크]](⌘나 Ctrl을 누른 채 클릭하면 옆에 열립니다), ![[임베드]], 콜아웃, 맨 위의 속성, #태그, ==하이라이트==가 그대로 보입니다. 오른쪽에는 개요와 태그, 이 문서를 가리키는 문서와 이 문서가 가리키는 문서가 나옵니다.
pane마다 모드가 셋입니다. Reading, Live(블록을 클릭하면 고칠 수 있고 Esc를 누르면 다시 렌더링됩니다), Source입니다. ⌘E(Mac이 아니면 Ctrl+E)로 읽기와 쓰기를 오갑니다.
pane 나누기. 오른쪽(⌘\)이나 아래(⌥⌘\)로 나눕니다. Mac이 아니면 ⌘ 대신 Ctrl을 씁니다. ×로 닫습니다. 같은 문서를 두 pane에 열어도 글은 하나이고, 폰 너비에서는 pane이 하나만 보입니다.
저장은 입력을 멈추고 1초가 지나면 저절로 됩니다. 그사이 장치의 문서가 바뀌었으면 띠가 떠서 Overwrite, Keep both, Take theirs 중 하나를 고르게 합니다.
그 밖에 복사, 다운로드, 공유, 옮기기, 이름 바꾸기(제목을 더블클릭), 삭제도 할 수 있습니다.
터미널의 경로(st 0.3.93 이상): 웹 터미널에서 Markdown 파일 경로를 ⌘-클릭(Mac이 아니면 Ctrl-클릭)하면 여기서 문서로 열립니다. 다른 파일의 경로는 뒤에 적힌 :line 위치에서 텍스트로 열립니다. Keep as document를 누르기 전에는 남지 않고, 누르면 사본을 한 번 남깁니다. 데스크탑 앱도 글로 적힌 .md 경로를 같은 식으로 문서로 엽니다. 이 장치의 터미널에서만 되고 Windows에서는 안 됩니다.

여기서 저장한 문서도 앱으로 갑니다. 데스크탑 앱의 문서 화면도 0.1.31부터 같은 방식으로 보이며, 이때 장치에 st 0.3.86 이상이 있어야 합니다.

pane으로 공유하기

어느 앱에서든 공유 시트로 텍스트, 링크, .md/.txt 파일을 sophonz에 공유하고 장치 › 세션 › 창 › pane을 고르면, 그 pane의 Compose에 보내지 않은 채로 열립니다. 초안은 보낼 때까지 pane마다 남습니다.