레퍼런스

개요

빠르게 찾아보는 참조 장입니다. 명령어 표·자주 묻는 질문·심화 질문·문제 해결을 정리합니다.

OpenArms의 공식 CLI는 python -m openarms 입니다. 점검 계열(doctor·board·inventory· session·phase·status)은 읽기 전용이고, setup·enroll만 설정을 기록합니다(미리보기·계획 모드 제공).

명령	하는 일
`python -m openarms doctor`	토큰 값을 읽거나 출력하지 않고 로컬 설정을 점검합니다.
`python -m openarms setup --provider <id>`	온보딩 마법사 — 필요한 설정을 git 제외 비공개 런타임 env 파일에 기록합니다(`--dry-run` 미리보기, `--from-env` 비대화).
`python -m openarms board`	PM이 읽는 보드 투영을 렌더합니다.
`python -m openarms provider inventory`	텔레그램 프로바이더 서비스 인벤토리(읽기 전용).
`python -m openarms provider session`	프로바이더 전경 세션 레지스트리를 점검합니다.
`python -m openarms provider enroll <id>`	프로바이더 스킬을 등록합니다(기본 계획, `--apply`로 기록). id는 hermes·codex·gemini·antigravity.
`python -m openarms phase`	페이즈 커서·라이브 재개 준비 상태를 점검합니다.
`python -m openarms status`	현재 페이즈 상태(읽기 전용).
`python -m openarms --version`	버전을 출력합니다(현재 0.0.2.5).
`python openarms/paths.py bootstrap`	`~/.openarms` 골격을 멱등하게 만듭니다.
`python3 scripts/dev_preflight.py`	의존성 import 점검(설치·네트워크 없음).
`PYTHONIOENCODING=utf-8 python3 -m pytest -q`	테스트 스위트를 돌립니다.

공통 옵션: --format text|json · --report <path> · --strict(블로커·위험 상태면 비-0 종료).

OpenArms는 에이전트인가요? — 아니요. 에이전트가 받는 전경 세션과 사람이 보는 표면을 일치시키는 계약 브리지입니다.
어떤 메신저를 쓰나요? — 현재는 텔레그램이 1차 표면이고, 프로바이더는 교체 가능합니다.
어떤 CLI 에이전트를 붙일 수 있나요? — 기동·입력 전달·출력 포착·결과 마커 인식을 하는 어댑터가 있으면 어떤 CLI 에이전트든 붙습니다. Hermes·AGY가 현재 증명 쌍입니다.
왜 클라우드 벡터를 안 쓰나요? — 검색을 그래프 탐색 + BM25 어휘 일치로 하기 때문입니다. 마크다운이 권위이고 파생물은 다시 계산됩니다.
끝난 작업은 지워지나요? — 아니요. supersede-not-delete로 보관에 물러나며 이력이 남습니다.
여러 프로젝트의 기억이 섞이지 않나요? — 프로젝트 루트 경로로 기억을 칸 나눠 무관한 프로젝트의 검색·군집이 섞이지 않습니다.

에이전트 프레임워크와 무엇이 다른가요? — 한 에이전트를 돌리는 것은 프레임워크 문제이고, 여러 워커를 공유 기억·사람 점검·거버넌스 기록과 함께 예측 가능하게 돌리는 것은 조율(관제) 문제입니다. OpenArms는 후자 — 에이전트 운영 관제면입니다.
사람 점검(human-in-the-loop)은 어디 있나요? — PM 판단이 그 자리입니다. 증거 강도가 오르지 않으면 슬라이스를 멈춰 사람에게 넘기고, 모든 개입이 보드·기억에 기록됩니다.
관측성은 어떻게 확보하나요? — 칸반 표면과 결정 아카이브가 추적 가능성입니다. 무엇이 결정됐고 왜 막혔는지, 어떤 증거가 계약을 닫았는지가 남습니다. 조율은 관측 없이는 추측입니다.
왜 tmux 실행석인가요? — 현재 라이브 전경 실행석의 backend일 뿐 제품 정체성이 아닙니다. 실행석은 pty·ssh 등으로 추상화될 예정입니다.
비밀은 어떻게 다루나요? — 봇 토큰·대상 채널은 소유자 로컬 비밀로 git 제외 env에 두고, doctor도 토큰 값을 출력하지 않습니다.

워커가 막혔습니다 — 블로커를 기록하고 다음 판단 소유자를 명시합니다. 증거 강도가 오르지 않으면 슬라이스를 멈추고(stop_and_report) 사람 판단으로 넘깁니다.
표면이 갈라집니다 — 전경 세션이 권위입니다. 텔레그램·보드가 전경과 어긋나면 전경을 기준으로 맞춥니다.
맥락을 잃었습니다 — 회상으로 과거 결정을 다시 불러옵니다. 종결된 결정은 되살아나지 않습니다.
설정이 의심스럽습니다 — python -m openarms doctor로 토큰 노출 없이 로컬 설정을 점검하고, python3 scripts/dev_preflight.py로 의존성을 확인합니다.

프로바이더별 세부 명령과 더 깊은 운영 FAQ는 사용 패턴이 쌓이는 대로 보강합니다 — 일부 작성중.