WIKI · Newtype Slaves · Nexus
TUI 명령어 레퍼런스
Newtype Slaves TUI 의 슬래시 명령과 단축키, 도구 승인 창, 그리고 터미널에서 쓰는 newtype CLI 명령과 플래그를 한곳에 정리했습니다.
재현 화면은 코드의 문구를 TUI 와 같은 모양으로 배치한 것입니다. ID 는 … 로 가렸습니다.
시작 화면과 화면 읽는 법
TUI 맨 아래 줄이 상태줄입니다: # 대화 이름 · ~ 모드 · * 모델, 그 아래 / 작업 폴더.
대화의 각 줄은 표시와 두 글자 이름으로 시작합니다.
| 표시 | 뜻 |
|---|---|
> 입력 | 내가 입력한 것 |
* 답변 | 모델의 답 |
~ 생각 / ~ 생성 | 생각 중 상태 / 지금 만들어지는 답 |
+ 도구 / $ 실행 | 도구 호출 / 셸 명령 실행(run_command) |
+ 완료 / ! 오류 | 도구 결과 [OK] 완료 / [FAIL] 실패 |
| 출력 | 셸 명령 출력(앞 16줄까지) |
? 승인 | 승인 결과 기록(승인함 · 거부함 · 자동 승인) |
= 안내 / @ 알림 | TUI 의 안내 / 백그라운드 작업 알림 |
/help — 전체 명령
/ 를 입력하면 명령 목록이 뜹니다: ↑↓ 선택 · Tab 완성 · Enter 실행 · Esc 닫기.
대화 다루기
| 명령 | 하는 일 |
|---|---|
/new | 새 대화를 시작합니다. 이전 대화는 보존됩니다. |
/clear | 화면을 정리하고 새 대화를 시작합니다. |
/name <이름> | 현재 대화 이름(상태줄 표시, 최대 60자). /name 보기, /name - 지우기, /rename 도 같습니다. |
/sessions [페이지] | 이 기기의 로컬 대화 목록(한 쪽 20개, * 현재 대화). Nexus 목록이 아닙니다. |
/load <ID> | 그 대화로 전환해 이어갑니다. 작업 폴더·모드·권한은 바꾸지 않습니다. |
/session | 현재 대화 ID 와 세션 기본값(모델·토큰·TTL). /session set 으로 토큰·TTL 변경(다음 실행부터). |
/compact | 대화를 요약해 이어갑니다(모델 호출·비용 가능). 원본은 보존됩니다. |
/export [md|json] | 대화 미리보기(파일로 저장하지 않음). |
/rewind <남길 턴 수> [--confirm] | 처음 N턴만 남깁니다. --confirm 없이는 확인 문구만 보여 줍니다. 파일·사용량은 되돌리지 않습니다. |
/memory · /init | 메모리 조회 요청 / AGENTS.md 생성 요청(일반 모델 턴). |
/plan [파일.md|work|off] | 계획 파일 고정 · 작업표 검증 · 조회 · 해제. |
/version · /quit | 버전 보기 / 종료(/exit, /q 도 같음). |
/new 다음 /name 결제 모듈 리뷰 처럼 이름을 먼저 정해 두면, 첫 메시지로 대화가 만들어질 때 이름이 저장됩니다.
모드 — auto 와 self-conscious
| 명령 | 하는 일 |
|---|---|
/mode | 현재 모드 보기. |
/mode auto | 기본. 사람이 입력한 턴에서 로컬 파일·셸·메모리 확인을 자동 승인합니다. 비밀·Nexus·custody·외부 도구는 계속 사람 확인. |
/mode self-conscious | 목표 달성까지 자율 진행(사람 턴당 계속 최대 12회). Esc 로 중단. /self, /sc 도 같습니다. |
/mode self-conscious 는 저장되어 다음 시작에도 이 모드로 켜집니다.
모드는 대화로 바꿀 수 없습니다. 사람이 직접 입력한 명령(또는 --mode 플래그)으로만 켭니다.
모델 프로필
| 명령 | 하는 일 |
|---|---|
/model | 현재 모델과 프로필 목록. |
/model add [이름] | 대화형 추가: 이름 → 공급자(openai · responses · anthropic · gemini, 0.20261005.3 부터 오픈웨이트) → 모델 → 엔드포인트 → API 키(가림 입력창) → 전환 여부. Esc 는 저장 없이 취소. |
/model use <이름> | 턴 사이에 전환합니다. 대화는 유지됩니다. 폴더별로 기억합니다. |
/model key <이름> | API 키 교체. |
/model remove <이름> | 프로필과 저장된 키 삭제(이름을 그대로 다시 입력해 확인). |
API 키는 macOS 키체인에만 저장되고 화면·파일·기록에 남지 않습니다.
/model add gpt
# 공급자: openai · 엔드포인트: https://api.openai.com/v1/chat/completions · 모델: <모델 이름>
/model add claude
# 공급자: anthropic · 모델: <Claude 모델 이름>
# API 키는 가림 입력창에 넣습니다
/model use claude/model add qwen-onprem
# 공급자: 오픈웨이트 (OpenAI 호환 서버)
# 엔드포인트: http://192.168.0.10:8000/v1/chat/completions (vLLM)
# 또는 http://127.0.0.1:11434/v1/chat/completions (Ollama)
/model use qwen-onprem"오픈웨이트 (OpenAI 호환 서버)" 공급자는 0.20261005.3 부터 있습니다. 사설·사내 주소(루프백, 10.x, 172.16–31.x, 192.168.x, 링크 로컬)에 한해 HTTP 와 키 없는 연결을 허용하고 처음 한 번 경고합니다. 호스트 이름은 사설 주소로 풀릴 때만 됩니다. 공개 인터넷 주소는 HTTPS 만 가능합니다.
Nexus · 위임 · 팀 명령
| 명령 | 하는 일 |
|---|---|
/nexus chat [on|off] | Nexus 대화(받은편지함 · 자동 수신 턴 · nexus_send/peers/inbox) 보기 · 다음 시작부터 켜기/끄기. |
/nexus send confirm [on|off|default] | Nexus 보내기를 사람이 확인할지. 기본: auto 에서 켜짐, self-conscious 에서 꺼짐. |
/grant [보낸 세션] [--tools a,b|all] [--paths p,q] [--turns N] [--ttl 8h|max] [--note …] | 그 세션의 Nexus 메시지가 범위 안 도구를 사람 확인 없이 실행하도록 허가. 기본: operator · 파일·셸 도구 · 작업 폴더 · 50턴 · 8h. all = 로컬 도구 15개, max = 서버 최대 7일. 입력한 명령은 바로 발급됩니다(대화로 하면 미리보기 승인). |
/grants · /revoke-grant <ID> | 이 세션의 실행 허가 목록 / 철회. |
/team · /team create [이름] [구성원,…] · /team confirm · /team cancel · /team fresh | 팀 명단 · 팀 만들기(사람 명령만) → 확인/취소 · 새 대화로 시작. 자세히: 세션으로 팀 구성하기. |
/nmcp mail-consent [on|off] | 원격 MCP 동의 페이지의 확인 메일 버튼(owner 전용, 기본 꺼짐). |
/update · /update check · /update confirm | 새 버전 확인 · 서명 확인 뒤 설치. 재시작은 직접. |
/restart | 턴이 끝나 저장되면 종료하고 다시 시작(같은 폴더의 대화·Nexus 세션으로). 자세히: 세션 이어받기. |
이 명령들은 저장 자격 증명으로 시작한(기본 newtype) 세션에서만 동작합니다. 직접 엔드포인트로 시작하면 "저장 자격 증명으로 시작하세요" 안내가 나옵니다.
키와 승인 창
| 키 | 동작 |
|---|---|
| Enter | 보내기 |
| Alt+Enter · Ctrl+J | 줄바꿈(최대 8줄) |
| Esc | 입력 지우기 · 응답 중이면 턴 취소 |
| Ctrl+C | 종료(입력이 비어 있으면 Ctrl+D 도) |
| ↑ ↓ | 입력 기록(200개) |
| Ctrl+U | 입력 지우기 |
사람 확인이 필요한 호출은 ? LOCAL CONFIRMATION 창으로 묻습니다. 1/y 승인, 2/n/Esc 거부, Enter 는 선택된 항목(기본은 거부). 실행 허가 범위 밖의 로컬 호출에는 1. 이번만 승인 · 2. 이 세션 동안 승인 · 3. 거부 세 가지가 나옵니다.
/secret DEPLOY_TOKEN — 값은 가림 입력창에만 넣고, 모델·대화·기록에는 보내지 않습니다(--session-secrets 로 시작한 경우).
- 비밀 값을 쓰는 셸 명령은 auto 모드에서도 사람에게 묻습니다. 명령 속 비밀은
[secret:password]로 가려집니다. 2로 거부하면? 승인 … 거부함이 기록되고 명령은 실행되지 않습니다.- auto 모드에서 사람이 입력한 턴의 로컬 셸 명령은 묻지 않고 실행됩니다.
터미널 명령 (CLI)
| 명령 | 하는 일 |
|---|---|
newtype | TUI 시작. 첫 실행이면 메일 등록 승인 · 폴더 신뢰 · 모델 설정. 같은 폴더면 같은 세션·대화로 돌아옵니다. |
newtype --version | 버전 출력. |
newtype --mode auto|self-conscious | 이 실행의 모드(저장하지 않음). |
newtype --model-profile <이름> | 저장된 모델 프로필로 시작. |
newtype --team <ID|이름> · --seat <자리> · --no-team | 그 팀으로 다시 들어가기 · 그 자리 잡기 · 팀 없이 시작. |
newtype update [--check] | 서명된 새 버전 확인 · 설치(크기·SHA-256 확인, 이전 바이너리 보관). 설치 뒤 다시 시작하세요. |
newtype nexus peers|send|inbox|log | Nexus 세션 보기 · 보내기 · 받은편지함 · 원장(JSON 한 줄씩). |
newtype nexus grant|grants|revoke-grant | 터미널에서 실행 허가 발급 · 목록 · 철회. |
newtype nmcp serve|setup claude|authorize|clients|revoke|mail-consent | MCP 연결(Claude Code 등). Nexus 페이지 참고. |
newtype nexus 하위 명령 예(재현 화면).화면 텍스트
$ newtype nexus peers $ newtype nexus send --to nmcp "go test 결과 확인 부탁" $ newtype nexus inbox --wait 60 $ newtype nexus log nmcp $ newtype nexus grant claude-newtype --session nmcp --tools all --ttl max $ newtype nexus grants --session nmcp $ newtype nexus revoke-grant <ID> --session nmcp # 출력은 JSON 한 줄씩 · 모든 명령 --credential-dir DIR (기본 ~/.newtype/credentials)
newtype release 는 운영자의 오프라인 릴리스 서명 도구입니다. 일반 사용자는 쓰지 않습니다.