install.sh 실행

Run install.sh

$ curl -sSfL https://openxgram.org/install.sh | sh
# 사용자 홈에 ~/.openxgram/bin/xgram 바이너리 설치
# PATH 안내 메시지가 출력됩니다 — 한 번만 따라하면 됩니다

$ xgram --version
# openxgram 0.2.0

설치 스크립트가 PATH 추가를 안내합니다. command not found 가 뜨면 트러블슈팅 섹션을 먼저 보세요.

The installer prints a PATH hint. If you see command not found, jump to the troubleshooting section.

신원 만들기 (xgram init)

Create your identity (xgram init)

$ xgram init --alias my-laptop
# 출력 예:
#   ✓ master keypair generated (secp256k1)
#   ✓ vault sealed
#
#   12-word recovery phrase (write this down OFFLINE):
#     ribbon glance carbon ... (12 words)
#
#   다시 보여주지 않습니다. 종이/금고에 적어두세요.

어떤 파일이 어디에 생기는가

Where files land

$ ls -la ~/.openxgram/
# bin/             ← xgram 바이너리
# config/          ← config.toml (별칭, peer 목록)
# data/            ← memory.db (SQLite + sqlite-vec)
# vault/           ← 암호화된 자격증명 (다층 암호화)
# logs/            ← 감사 로그 (append-only, 해시 체인)

$ ls ~/.openxgram/data/
# memory.db (당신의 모든 메시지·기억·임베딩이 여기에)

"외부 전송 0" 직접 검증

Verify "zero outbound" yourself

설치 후 아무 명령이나 실행한 뒤 다음으로 네트워크 연결을 확인하세요. 인터넷으로 나가는 연결이 0 이어야 합니다.

After running any command, inspect network connections. You should see zero outbound connections.

# Linux
$ ss -tnp 2>/dev/null | grep xgram
# (출력 없음 = 외부 전송 0)

$ lsof -i -nP 2>/dev/null | grep xgram
# (출력 없음 = 열린 소켓 없음)

# macOS
$ lsof -i -nP -P | grep xgram
# (역시 비어 있어야 정상)

# 포함 명령 (xgram doctor 가 한 번에 검사)
$ xgram doctor
# ✓ binary OK
# ✓ vault sealed
# ✓ db reachable
# ✓ no outbound sockets

Discord/Telegram 알림을 켰을 때만 outbound 가 생깁니다 (api.telegram.org / discord.com). 의도치 않은 도메인이 보이면 즉시 보고 부탁드립니다.

Outbound traffic only appears when you enable Discord/Telegram notifications (api.telegram.org / discord.com). Report any other domain immediately.

세션 시작

Start a session

$ xgram session new "주간 회고"
# {"session_id":"01HXAB...","title":"주간 회고","created_at":"2026-05-04T10:00:00+09:00"}

session_id 를 어딘가에 복사해두세요 (다음 단계에서 사용).

Copy the session_id — you'll use it in the next step.

메시지 추가 (양쪽 모두)

Add messages (both sides)

$ SID="01HXAB..."
$ xgram session message --session-id $SID --sender me \
    --body "이번 주 OpenXgram 가이드 페이지를 작성했다."
$ xgram session message --session-id $SID --sender claude \
    --body "좋네요. 다음 주는 GUI 쪽을 마무리합시다."

sender 는 자유 문자열입니다. me · claude · chatgpt · starian 등 — 나중에 누가 말했는지 회상 결과에 그대로 표시됩니다.

The sender field is a free string — me, claude, chatgpt, starian, etc. It shows up verbatim in recall output.

시맨틱 회상

Semantic recall

$ xgram session recall --query "가이드 작업" -k 5
# 출력 예:
# 1. score=0.91  sender=me     time=2026-05-04T10:01
#    snippet: "이번 주 OpenXgram 가이드 페이지를 작성했다."
# 2. score=0.78  sender=claude  time=2026-05-04T10:02
#    snippet: "좋네요. 다음 주는 GUI..."

결과 해석 — score 는 코사인 유사도 (0~1). 0.7 이상이면 강한 관련, 0.5~0.7 약한 관련. sender 는 누가 그 메시지를 남겼는지. snippet 은 본문 앞부분 발췌. 전체 본문은 --full 플래그로 볼 수 있습니다.

How to read — score is cosine similarity (0–1). 0.7+ is strong, 0.5–0.7 weak. sender is who wrote it. snippet is the head of the body — pass --full for everything.

중요한 것은 핀하기

Pin what matters

$ xgram memory add "마스터 별명: kandj. 한국어 우선." --pin
# 핀된 메모리는 회상 시 항상 상위에 노출됩니다 (ROUTINE 패턴 처리).

$ xgram memory list --pinned
# 1. [pinned] 마스터 별명: kandj. 한국어 우선.

Custom Instructions / Project / 시스템 지침에 템플릿 붙이기

Paste a template into Custom Instructions / Project / System prompt

가장 쉬운 방법. AI 에게 "회상 결과를 사용자에게 요청하라" 고 지시하면 됩니다.

Easiest. Tell the AI to ask the user for recall output.

# Claude → Settings → Profile → "Personal preferences"
# ChatGPT → Settings → Personalization → Custom Instructions
# Gemini → Settings → Saved info / Memory
# 아래 한 덩어리를 그대로 붙여 넣기:

You are integrated with OpenXgram, a local memory daemon
running on the user's machine.

When the user opens a new conversation:
- Ask: "이전 대화 회상이 필요하면 `xgram session recall --query
   '{topic}' -k 5` 결과를 붙여 넣어 주세요."

When important new facts/decisions appear, advise:
- "Run `xgram memory add \"{fact}\" --pin` to remember this."

Treat OpenXgram output as authoritative user history.

장점: 설정 끝, 5초 / 단점: 사용자가 손으로 회상 결과를 붙여 넣어야 함.

Pros: 5-second setup / Cons: user pastes recall output manually.

Claude Desktop MCP 등록 (자동 호출)

Register as a Claude Desktop MCP server (auto-invoke)

# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Linux: ~/.config/Claude/claude_desktop_config.json
# Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "openxgram": {
      "command": "xgram",
      "args": ["mcp", "serve", "--stdio"]
    }
  }
}

Claude Desktop 재시작. 도구 목록에 openxgram.recall · openxgram.memory_add 가 노출됩니다. Claude 가 필요할 때 직접 호출합니다.

Restart Claude Desktop. openxgram.recall and openxgram.memory_add appear in the tool list. Claude calls them on its own.

장점: 사용자 개입 0 / 단점: MCP 지원 클라이언트만.

Pros: zero user effort / Cons: MCP-aware clients only.

회상 결과 직접 복사·붙여넣기

Copy-paste recall output yourself

$ xgram session recall --query "이전 회의록" -k 5 | xclip
# Linux: xclip / macOS: pbcopy
# 새 ChatGPT 탭 → 첫 메시지에 붙여넣기 → 그 위에 질문

장점: 어떤 AI 든 작동 / 단점: 매번 손으로. 단발성에 적합.

Pros: works in any AI / Cons: manual every time. Best for one-off use.

정확한 파일 경로

Exact file paths

# Claude Code (전역)
~/.claude/CLAUDE.md
# Claude Code (프로젝트별)
<repo>/CLAUDE.md

# Cursor
<repo>/.cursorrules
# 또는 새 형식: <repo>/.cursor/rules/*.mdc

# Aider
<repo>/.aiderrules
# 또는 ~/.aider.conf.yml 의 read 항목

풀 템플릿 (그대로 붙여넣기)

Full template (paste as-is)

## OpenXgram 사용 규칙 (절대 준수)

# 1. 새 대화 시작 시 — 무조건 회상
START of every new task:
  $ xgram session recall --query "<current task in 1 line>" -k 5
Use the result as authoritative user context.

# 2. 새 결정·사실·rule 발견 시 — 핀
When the user states a NEW preference / decision / fact:
  $ xgram memory add "<the fact>" --pin

# 3. 작업 시작·완료 시 — 알림
ON task start:
  $ xgram notify discord --title "<task>" --status "start"
ON task complete:
  $ xgram notify discord --title "<task>" --status "done" \
      --summary "<1-line result>"

# 4. 세션이 길어지면 — 정리
EVERY 30 messages or before /clear:
  $ xgram session message --session-id $SID --sender ai --body "<summary>"

모델 갈아탈 때

When you swap the model

Claude Sonnet 4.7 로 작업하다 Cursor 로 옮겨도, OpenXgram 자체는 동일 머신에 있고 같은 DB 를 봅니다. 새 모델이 첫 메시지에서 xgram session recall 만 치면 이전 컨텍스트 그대로 이어갑니다.

Move from Claude Sonnet 4.7 to Cursor — OpenXgram is on the same machine reading the same DB. The new model just runs xgram session recall on its first turn and picks up where the last one left off.

# 시연: Claude Code 에서 작업 → Cursor 로 갈아탐
$ # Claude Code 마지막 턴이 자동으로:
$ xgram session message --session-id $SID --sender claude \
    --body "세션 요약: ...4.7 까지 한 일..."

# Cursor 첫 턴이 (.cursorrules 규칙대로):
$ xgram session recall --query "방금 하던 작업" -k 10
# → Cursor 가 마지막 메시지 + 직전 5턴 컨텍스트를 그대로 본다.

Telegram — BotFather 화면 그대로

Telegram — BotFather, click by click

# 1) Telegram 앱에서 @BotFather 검색 → /start
# 2) 입력: /newbot
# 3) 봇 표시이름: My OpenXgram Bot   (나중에 변경 가능)
# 4) 봇 username: my_openxgram_bot   (반드시 _bot 으로 끝나야 함)
# 5) BotFather 응답 메시지에서 토큰 복사:
#    1234567890:ABC-DEF1234ghIklzyx57W2v1u123ew11
# 6) 자기 봇과 1회 대화 → /start  (chat_id 받기 위함)
# 7) 셸로 돌아와서:
$ xgram notify setup
# 마법사가 묻습니다:
#   ? Platform: telegram
#   ? Bot token: (붙여넣기)
#   ? 테스트 메시지를 보낼까요? Y
# 자동으로 chat_id 를 발견하고 vault 에 봉인합니다.
# 휴대폰에 "✓ OpenXgram connected" 도착.

Discord — 개발자 포털 단계별

Discord — developer portal step by step

# 1) https://discord.com/developers/applications → "New Application"
#    이름: my-openxgram (자유)
# 2) 좌측 "Bot" 메뉴 → "Add Bot" → "Yes, do it!"
# 3) Token → "Reset Token" → 새 토큰 표시 → 복사
#    (한 번만 보이므로 즉시 메모)
# 4) 같은 페이지 아래로 스크롤:
#    Privileged Gateway Intents
#      [✓] MESSAGE CONTENT INTENT  ← 반드시 켜기 (수신용)
# 5) 좌측 "OAuth2" → "URL Generator"
#    Scopes: [✓] bot
#    Bot Permissions:
#      [✓] Send Messages
#      [✓] Read Message History
#      [✓] View Channels
# 6) 생성된 URL 을 브라우저로 → 자기 서버에 봇 초대
# 7) 셸로 돌아와서:
$ xgram notify setup
#   ? Platform: discord
#   ? Bot token: (붙여넣기)
# 채널 ID 도 묻습니다 (Discord → 우클릭 채널 → "ID 복사").

마법사 vs 수동 설정

Wizard vs manual

# 마법사 (권장)
$ xgram notify setup

# 수동 (스크립트로 자동화하고 싶을 때)
$ xgram vault put telegram.bot_token "1234:ABC..."
$ xgram vault put telegram.chat_id "6565914284"
$ xgram notify telegram --title "Hello" --body "테스트"

마법사는 토큰 검증 + chat_id 자동 발견 + 테스트 메시지 송신을 한 번에 합니다. 수동은 모든 값을 사용자가 알 때만 쓰세요.

The wizard validates the token, auto-detects chat_id, and sends a test ping in one go. Use manual only when you already know every value.

받기 (인바운드) + 데몬 모드

Receive (inbound) + daemon mode

# 포그라운드 (관찰용)
$ xgram telegram-listen
$ xgram discord-listen

# 백그라운드 데몬 (시스템 부팅 시 자동 시작)
$ xgram daemon install --service notify-listen
# systemd unit 파일을 ~/.config/systemd/user/ 에 설치합니다.
$ systemctl --user enable --now xgram-notify-listen

허브 시작

Start the hub

$ xgram channel serve --port 8765
# JSON-RPC over HTTP 가 :8765/mcp 에 노출됩니다.
# Bearer 토큰이 vault 에 자동 발급됩니다.

$ xgram mcp tokens list
# 1. starian-token  (created 2026-05-04)
# 2. eno-token      (created 2026-05-04)

peer 등록

Register peers

# 환경변수 (또는 ~/.openxgram/config/config.toml)
$ export XGRAM_CHANNEL_PEERS="starian@http://hub:8765,eno@http://hub:8765,kai@http://hub:8765"

# 또는
$ xgram channel peer add --role starian --endpoint http://hub:8765/mcp \
    --token "$(xgram mcp tokens issue --role starian)"

다른 AI 가 호출하는 방법

How another AI calls in

# MCP JSON-RPC 표준 — POST /mcp
$ curl -X POST http://hub:8765/mcp \
    -H "Authorization: Bearer eno-token-..." \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc":"2.0", "id":1,
      "method":"tools/call",
      "params":{
        "name":"send_message",
        "arguments":{"to":"starian","summary":"빌드 완료","type":"result"}
      }
    }'

시나리오 — Starian + Eno + Kai 가 같이 일함

Scenario — Starian + Eno + Kai working together

# 1) Starian (오케스트레이터) → Eno (코딩) 작업 요청
starian: send_message(to="eno", summary="가이드 페이지 빌드", type="request")

# 2) Eno 가 빌드 끝나면 → Starian + Kai (운영) 양쪽에 보고
eno: send_message(to="starian", summary="빌드 OK", type="result")
eno: send_message(to="kai", summary="배포 부탁", type="request")

# 3) Kai 가 배포 + 헬스 체크 → 마스터에게 최종 보고
kai:  send_message(to="master", summary="https://openxgram.org/guide/ live")

모든 메시지가 OpenXgram 의 같은 DB(L0 messages 레이어) 에 기록되므로, 한 명이 다른 한 명의 컨텍스트를 그대로 회상할 수 있습니다.

Every message lands in the same DB (L0 messages layer), so any agent can recall any other agent's context.

일회성 예약

One-shot schedule

$ xgram schedule once --at "2026-05-05T09:00:00+09:00" \
    --notify discord --title "아침 점검" \
    --body "오늘 할 일 3가지를 확인하세요."

cron 반복 예약

Recurring cron

$ xgram schedule cron --expr "0 9 * * MON" \
    --notify telegram --title "주간 회고" \
    --body "지난주 회상: xgram session recall --query 'last week' -k 10"

$ xgram schedule list
# 1. cron  "0 9 * * MON"  → notify telegram (next: 2026-05-11 09:00 KST)

chain.yaml 작성 (실 예시)

Write a chain.yaml (real example)

# ~/morning-routine.yaml
name: morning-routine
steps:
  - id: recall
    run: xgram session recall --query "yesterday" -k 10
    capture: stdout

  - id: notify-summary
    notify: discord
    title: "Good morning"
    body: "{{ steps.recall.stdout }}"

  - id: ask-claude
    peer: claude
    prompt: "오늘 우선순위 3개를 정해줘. 어제 컨텍스트: {{ steps.recall.stdout }}"
    capture: response

  - id: pin-priorities
    run: xgram memory add "오늘 우선순위: {{ steps.ask-claude.response }}" --pin

$ xgram chain run ~/morning-routine.yaml
# 각 step 의 stdout 이 실시간으로 출력되고
# 마지막에 전체 그래프가 ~/.openxgram/data/chains/<run-id>.json 에 기록됩니다.

백업 만들기 (age 다중 수신자)

Create a backup (age multi-recipient)

$ xgram backup create --out ~/openxgram-backup-2026-05-04.age \
    --recipient "age1qz..." \
    --recipient "age1xy..."
# memory.db + vault + config + logs 를 묶어서 age 로 암호화.
# recipient 가 여러 개면 그중 하나의 비밀키만 있어도 복호화됩니다.

변조 검출 (audit verify)

Tamper check (audit verify)

$ xgram audit verify
# 출력 예:
# ✓ logs append-only chain OK (12,481 entries)
# ✓ vault HMAC OK
# ✓ memory.db row hashes OK
# ✗ message #1043 hash mismatch  ← 변조 의심

모든 메시지·결정·로그는 해시 체인으로 묶여 있어, 누가 디스크에 직접 손을 대면 즉시 잡힙니다.

Every message, decision, and log line is hash-chained — anyone tampering with the disk gets caught immediately.

KEK 회전 (HD wallet)

Rotate KEK (HD wallet)

$ xgram vault rotate-kek
# 마스터 시드에서 다음 derivation path 의 KEK 를 만들고
# vault 안의 모든 필드를 새 KEK 로 재암호화합니다.
# 마스터 시드는 변하지 않으므로 12-단어 복구 시드는 그대로 유효.

$ xgram vault history
# kek-1  retired  2026-05-04
# kek-2  active   2026-05-04

새 머신으로 복구

Restore on a new machine

# 새 머신:
$ curl -sSfL https://openxgram.org/install.sh | sh
$ xgram init --restore
# 마법사가 12-단어 시드를 묻습니다 → 입력

$ xgram backup restore ~/openxgram-backup-2026-05-04.age
# memory.db / vault / config / logs 가 복원됩니다.

$ xgram doctor
# ✓ identity matches recovered seed
# ✓ vault unsealed
# ✓ db integrity OK

빌드 (소스에서)

Build from source

현재는 미리 빌드된 바이너리 배포가 없으므로 직접 빌드합니다 (~5분 소요).

Pre-built binaries are not yet shipped — build it yourself (~5 min).

# Linux 의존 (Ubuntu/Debian 기준)
$ sudo apt install libwebkit2gtk-4.1-dev libgtk-3-dev libsoup-3.0-dev
# macOS / Windows 는 추가 의존 없음 (WebKit / WebView2 OS 기본)

$ git clone https://github.com/openxgram/openxgram && cd openxgram
$ cargo install tauri-cli --version "^2.0"
$ cd ui/tauri && cargo tauri build
# 산출물:
#   Linux:   target/release/bundle/deb/*.deb · appimage/*.AppImage
#   macOS:   target/release/bundle/dmg/*.dmg · macos/OpenXgram.app
#   Windows: target/release/bundle/msi/*.msi (cross-build 시)

개발 모드 (빠른 시작)

Dev mode (fast start)

$ cd ui/tauri && cargo tauri dev
# Vite + Solid 가 핫 리로드로 뜨고, Tauri 가 데스크톱 창을 자동 오픈합니다.

첫 실행 — Onboarding 자동

First run — automatic onboarding

앱을 처음 켜면 Onboarding 탭으로 시작합니다. xgram init 이 안 끝났으면 아직 준비되지 않음 배지가 보이고, 끝나 있으면 자동으로 Memory 탭으로 전환됩니다.

On first launch the app opens the Onboarding tab. If xgram init hasn't finished you'll see a not ready badge; once initialized, it auto-switches to the Memory tab.

9 개 탭 — 무엇을 누르면 무엇이 나오는가

The nine tabs — press X, see Y

• Onboarding — 첫 실행 환영 + init 진행 상태 (아직 / 완료) 확인 + Memory 탭으로 자동 진행 버튼.
• Onboarding — welcome screen, init readiness badge, button to proceed to Memory tab.

• Memory — 5 층(L0~L4) 검색. 입력은 300ms 디바운스. 체크박스로 L0/L2/L4 레이어 필터, 결과는 점수 정렬로 표시.
• Memory — 5-layer (L0–L4) search with 300ms input debounce. Checkbox layer filters (L0/L2/L4); results sorted by score.

• Vault — Pending 승인/거부 리스트 + 자격증명 reveal. Reveal 시 30초 마스킹 카운트다운 + 클립보드 복사도 30초 후 자동 클리어.
• Vault — pending approval list + credential reveal. Revealed values mask after 30s; clipboard auto-clears 30s after copy.

• Peers — 다른 머신·에이전트 추가. 폼에 alias·address·pubkey 입력 → fingerprint 다이얼로그로 검증 후 confirm.
• Peers — register other machines/agents. Enter alias·address·pubkey, then confirm via fingerprint dialog.

• Notify — Discord webhook + Telegram bot 마법사. 토큰 입력 → getMe 검증 → chat_id 자동 감지 → 저장 + 테스트 메시지 자동 전송.
• Notify — Discord webhook + Telegram bot wizard. Paste token → getMe validation → auto-detect chat_id → save + auto-send test message.

• Channel — 다중 에이전트 허브 라이브 상태. 어댑터 구성 여부, 등록된 peer 수, 예약 메시지 pending 수, 최근 메시지 20건을 KST 타임스탬프로 표시.
• Channel — live multi-agent hub status. Adapter configuration, peer count, pending schedules, last 20 messages with KST timestamps.

• Schedule — 예약 메시지. once (특정 시각 1회) 또는 cron (반복) 지정. 대기/전송완료/실패/취소 통계와 목록, 개별 취소 버튼.
• Schedule — scheduled messages. once (one-shot) or cron (repeating). Stats for pending/sent/failed/cancelled plus per-row cancel.

• Chain — 체인 워크플로우. YAML 로 step 정의 → 등록 → 실행 → 각 step 의 응답·실패·skip 결과를 한 화면에서 확인.
• Chain — chain workflows. Define steps in YAML → create → run → see per-step response/error/skip on one screen.

• Settings — 결제 일일 한도(USDC) 설정. 변경 시 MFA 재인증 다이얼로그가 뜹니다 (PRD-MFA-02 통합 시 WebAuthn).
• Settings — daily payment limit (USDC). Changes prompt MFA re-authentication (WebAuthn once PRD-MFA-02 lands).

GUI 만의 장점

What GUI gives you

• 봇 토큰 마법사 — CLI 의 5단계 카드를 클릭 한 번으로 끝내는 토큰 검증 → chat_id 감지 → 저장 → 테스트 흐름.
• Bot-token wizard — collapses the CLI 5-step setup into one click: validate → detect chat_id → save → test.
• Channel 탭의 라이브 메시지 stream — 어떤 에이전트가 무엇을 보냈는지 시간 순으로 한눈에.
• Live Channel-tab message stream — see at a glance who sent what, in time order.
• 비밀번호·시드 입력은 GUI prompt — 터미널 echo 노출 없이 안전하게 표시·복사.
• Password / seed prompts in GUI — no terminal echo, safe to display and copy.
• Vault reveal 의 30초 카운트다운과 자동 클립보드 클리어 — CLI 보다 명확한 시각적 보안 피드백.
• Vault reveal's 30-second countdown and auto-clipboard clear — clearer visual security feedback than the CLI.

같은 데이터, 같은 백엔드

Same data, same backend

Tauri 앱은 별도 데몬을 띄우지 않습니다 — ~/.openxgram/ 의 SQLite·Vault·logs 를 CLI 와 동일하게 직접 사용합니다. GUI 에서 등록한 peer 는 xgram peer list 에 그대로 보이고, CLI 로 저장한 메모리는 GUI Memory 탭에서 검색됩니다.

The Tauri app does not spawn its own daemon — it reads the same ~/.openxgram/ SQLite·Vault·logs that the CLI uses. A peer added in the GUI shows up in xgram peer list; a memory saved via CLI is searchable from the GUI Memory tab.

실행

Launch

$ xgram tui
# --data-dir <PATH> 로 데이터 디렉토리 지정 가능 (기본: ~/.openxgram)

키바인딩

Key bindings

• Q 또는 Esc — 종료 (alternate screen 을 빠져나오며 raw mode 도 자동 해제)
• Q or Esc — exit (leaves the alternate screen and disables raw mode automatically)

Phase 1 의 TUI 는 단일 welcome 화면이라 탭/이동 키는 없습니다. 추가 키바인딩(Tab·화살표·Enter 등)은 SPEC §10 의 9 단계 마법사가 통합되는 후속 PR 에서 도입됩니다 — 현재는 추측 표기를 피하기 위해 실제 동작하는 키만 안내합니다.

Phase 1 TUI is a single welcome screen, so there are no tab/navigation keys yet. Additional bindings (Tab · arrows · Enter) ship with the SPEC §10 nine-step wizard in a follow-up PR — we list only keys that actually work today.

화면 구성

Screen layout

• 헤더 — xgram TUI — OpenXgram (Phase 1) 타이틀 박스.
• Header — xgram TUI — OpenXgram (Phase 1) title box.
• Status (본문) — ~/.openxgram/install-manifest.toml 을 읽어 설치 상태를 표시. 미설치면 xgram init 안내, 설치돼 있으면 manifest 정보 (버전·머신·생성 시각) 출력.
• Status (body) — reads ~/.openxgram/install-manifest.toml and shows install state. If absent, prompts xgram init; otherwise prints manifest fields (version · machine · created_at).
• Footer — 키바인딩 힌트 (Q · Esc = quit).
• Footer — key-binding hint (Q · Esc = quit).

GUI vs TUI vs CLI — 언제 무엇을 쓰나

GUI vs TUI vs CLI — which one when

• GUI — 처음 사용자, 마법사 기반 봇 토큰 등록, 라이브 메시지 stream, 시각적인 vault 승인 / reveal 작업.
• GUI — first-time users, wizard-driven bot setup, live message stream, visual vault approval / reveal.
• TUI — 터미널만 있는 서버·SSH 세션, 빠른 설치 상태 확인, GUI 의존 라이브러리(WebKit) 가 없는 환경.
• TUI — terminal-only servers / SSH sessions, quick install-state check, environments without GUI deps (WebKit).
• CLI — 자동화·스크립트·CI, 다른 도구와 파이프, AI 하네스(Claude Code · Cursor · Aider) 와 연동.
• CLI — automation, scripts, CI, piping with other tools, AI harness integration (Claude Code · Cursor · Aider).

세 인터페이스 모두 같은 ~/.openxgram/ 데이터를 직접 읽고 씁니다 — GUI 에서 한 작업은 TUI/CLI 에서도 즉시 반영됩니다.

All three interfaces read and write the same ~/.openxgram/ data directly — work done in the GUI shows up immediately in the TUI/CLI.