본문으로 건너뛰기
참조

Nexia CLI

전체 명령, 단계별 질문, 옵션, 실행 위치, 인증, 자동화와 오류 복구를 설명합니다.

Nexia CLI

프로젝트·앱은 create, 앱 내부 코드는 make로 생성합니다. 옵션을 입력하면 해당 질문을 건너뛰고, 입력하지 않은 설정은 단계별로 묻습니다.

시작하기

Node.js 22.12+, npm 11.x, PHP 8.5.12+, Composer가 필요합니다.

코드 예시
Shell
npm install -g @nexia/cli@alpha
nexia setup --devtools
nexia create project my-project
cd my-project
nexia create app people
cd people
composer install --no-scripts
npm install
nexia make resource Note
nexia dev

dev는 켜 두세요. 새 앱은 두 번째 터미널의 같은 앱 폴더에서 nexia db migrate를 실행하고 완료된 뒤 엽니다. 이후 파일 저장만으로 migration을 적용하지 않으며, 준비되면 같은 명령을 다시 실행합니다.

기존 프로젝트에 참여하려면 빈 프로젝트 폴더에서 nexia connect <project-id>를 실행하고 브라우저에서 승인하세요. 필요한 앱 저장소를 바로 아래 폴더에 clone한 뒤 의존성을 설치하고 dev를 실행합니다. 프로젝트 폴더와 각 앱 저장소는 구분합니다. 기존 AGENTS.md는 덮어쓰지 않습니다.

CLI 업데이트

업데이트 페이지에서 공개 CLI alpha 버전과 릴리스 내용을 확인하세요. 내 컴퓨터에 설치된 버전은 nexia --version으로 확인합니다. CLI는 Core·SDK와 별도로 설치됩니다.

nexia update --dry-run은 설치 없이 npm alpha 채널을 확인합니다. nexia update는 정확한 업데이트 버전을 보여주고 확인을 받은 뒤 설치합니다. 다른 패키지 관리자로 설치했다면 해당 방식으로 갱신하세요. CLI 업데이트는 중단된 App 실행이나 DB 명령을 자동 재실행하지 않습니다.

전체 명령

모든 명령 앞에는 nexia를 붙입니다.

명령기능
docs앱 개발 시작 가이드 읽기
docs search <query>공개 문서 검색·공백이 있는 검색어는 따옴표 사용
docs read <document-id>공개 문서의 Markdown 본문 읽기
setup환경과 앱 생성 도구 준비
create [project|app] [directory]대상을 선택하고 프로젝트 또는 앱 생성
connect [project-id]인증 후 현재 프로젝트 폴더 연결
login [project-id]폴더 연결을 바꾸지 않고 인증·재인증
logout인증 해제·폴더 연결과 데이터 유지
make [resource|page] [name]대상과 코드 이름을 선택하고 생성
dev전체·Config 설정·개별 앱을 선택해 개발
updatenpm alpha 채널에서 CLI 업데이트
test [--frontend] [--database] [--filter name] [--testsuite name]앱 독립 테스트 실행. frontend는 database·testsuite와 함께 사용 불가
dev config프로젝트의 기본 개발 앱 선택 저장
ps추적 중인 로컬 개발 세션 조회
stop [--port N]샌드박스 데이터를 보존하며 현재 프로젝트의 로컬 세션 종료
check앱 소스 검사
status인증·프로젝트·폴더·샌드박스 상태 조회
db migrate앱 샌드박스 마이그레이션 요청
db local선택한 앱의 개발 DB를 PC의 PostgreSQL로 초기 설정
db accessNexia 제공 샌드박스 DB의 외부 SQL 접속 설정
db seed [key]앱 Seeder 실행, 키 지정 시 기존 fixture 실행
db status마이그레이션 파일·배치·진단 조회
submit기존 Git 버전 태그 심사 제출
submit list [--page N]현재 프로젝트 또는 앱의 최근 제출 목록
submit status [id]제출 상태 조회
submit cancel [id]취소 가능한 제출 취소
submit retry [id]재시도 가능한 제출 재요청
help [command]명령별 도움말
--version설치된 CLI 버전

nexia만 실행하면 도움말을 표시합니다. nexia create, nexia make, nexia db는 작업 선택부터 질문합니다. ↑/↓로 이동하고 Enter로 선택하며 Esc로 취소합니다. 원시 입력을 지원하지 않는 터미널에서는 번호나 값으로 입력합니다.

질문과 최종 확인

명시한 옵션은 검증 후 그대로 사용하며 다시 묻지 않습니다. 미입력 설정은 설명과 기본값을 제시합니다. 잘못 입력하면 해당 질문을 반복합니다. 메뉴를 표시하지 않으면 메뉴 그룹·아이콘·순서 질문은 생략합니다. 추가 언어를 선택한 경우에만 그 언어 이름을 묻습니다.

앱·리소스·페이지 생성의 마지막에는 설정과 대상 폴더를 보여주고 생성·설정 수정·취소를 선택합니다. Ctrl+C 또는 입력 종료로 취소할 수 있습니다. 확인 전 생성은 실행되지 않습니다. 기존 생성기의 사전 검사를 먼저 실행합니다. 리소스 생성은 기존 파일·등록을 건너뛰고, 페이지 생성은 충돌 시 거부합니다. 기존 소스를 덮어쓰지 않습니다. 실제 OS 쓰기 오류가 발생하면 이미 보고된 파일 변경을 확인해야 할 수 있습니다.

코드 예시
Shell
nexia create app people --vendor acme --family people
nexia make resource LeaveRequest --label-ko '휴가 신청'
nexia make page Summary --label-ko '요약' --no-record --no-navigation
nexia help make resource

앱 생성

질문: 폴더 → 코드 이름 → 패키지 소유자 → 앱 식별자 → 표시 이름 → 기능 그룹 → 테이블 접두사 → 선행 앱 → 확인.

옵션의미·기본값
--namePHP 코드 이름·폴더 이름에서 추천
--vendorComposer/npm 소유자·필수
--key안정적인 앱 식별자·코드 이름에서 추천
--display-name화면 표시 이름·코드 이름 기본값
--family메뉴 기능 그룹·필수
--table-prefixDB 테이블 접두사·앱 식별자에서 추천
--prerequisite필수 선행 앱 식별자·반복 가능·기본 없음

--vendor acme, --key people은 acme/people, @acme/people 패키지를 만듭니다. 등록 전에 안정적인 식별자를 정하세요. 앱 생성은 등록·설치가 아닙니다. 기존 폴더는 dry-run에서도 거부합니다.

리소스 생성

질문: 앱 → 코드 이름 → 한국어 표시·목록 이름 → 중국어 이름 추가 여부 → 데이터 소유 범위 → 메뉴 표시 → 메뉴 설정 → 확인.

옵션의미·기본값
--label-ko직접 작성한 한국어 이름·필수
--label-ko-plural한국어 목록 이름·단수 이름 기본값
--label-zh중국어 이름·생략 시 기존 영어 fallback
--label-zh-plural중국어 목록 이름·단수 이름 기본값
--record-ownerlegal_entity 기본값 또는 tenant
--navigation / --no-navigation메뉴 표시·기본 표시
--navigation-groupoperations 기본값
--navigation-subgroup메뉴 하위 그룹·기본 없음
--iconbox 기본값
--sortauto 기본값·생성기의 다음 순서 유지, 또는 숫자

데이터 소유 범위와 접근 권한은 별개입니다. 법인별 소유를 선택했다고 접근 권한이 부여되지 않습니다. 영어 이름은 코드 이름에서 생성하고 중국어 미입력 시 기존 fallback을 유지합니다. 이번 변경은 번역 생성 규칙을 바꾸지 않으며 범용 --label locale=value는 제공하지 않습니다.

페이지 생성

질문: 앱 → 코드 이름 → 한국어 표시 이름 → 개별 항목 조회·수정 화면 포함 여부 → 메뉴 표시·그룹·순서 → 확인.

옵션은 --label-ko, --record / --no-record, --navigation / --no-navigation, --navigation-group, --sort입니다. 레코드 화면과 메뉴는 기본 포함, 그룹은 operations, 순서는 100입니다. 페이지는 모델·마이그레이션·리소스를 만들지 않습니다. 생성 후 업무 쿼리를 구현하세요.

메뉴 그룹은 insights, management, operations, master-data, settings 중 선택합니다. --no-navigation과 메뉴 상세 옵션은 함께 사용할 수 없습니다. 중복 옵션·상충하는 참/거짓 옵션도 오류입니다. 필드·관계 설계기와 강제 덮어쓰기는 제공하지 않습니다.

실행 위치와 대상 선택

앱 하위 디렉터리에서도 상위 폴더를 찾아 동작합니다. --app <폴더명 또는 식별자>를 우선하고, 없으면 현재 앱·유일한 앱을 선택합니다. 프로젝트에 여러 앱이 있으면 선택 질문을 표시합니다.

명령프로젝트 루트앱 내부
create app바로 아래에 생성소속 프로젝트의 형제 앱으로 생성
make, db, submit대상 앱 선택현재 앱
check전체 앱현재 앱
dev프로젝트 앱 선택프로젝트 앱 선택
connect실행 가능프로젝트 루트로 이동 안내

dev --app people은 특정 앱만 개발합니다. 기본 포트는 4310이며 --port로 바꿉니다. 컨테이너는 --container를 사용합니다. 프로젝트 내 앱은 하나의 포트를 공유하며 전체 앱을 선택한 경우에만 새 앱이 자동으로 합류합니다. 비대화형 환경에서 대상을 제한하려면 --app을 반복하세요. 저장한 Config Apps는 자동 적용되지 않습니다. 중복 식별자와 심볼릭 링크 폴더는 실행하지 않습니다.

dev는 등록·샌드박스 준비·소스 동기화·프런트 감시를 담당합니다. 소스 제한은 2000파일, 파일당 2 MiB, 전체 16 MiB이며 비밀 파일·의존성·심볼릭 링크는 제외합니다. 샌드박스 보존 한도는 100리비전/512 MiB입니다. 데이터는 자동 초기화하지 않습니다. Ctrl+C는 로컬 감시를 종료합니다. 기존 쓰기 임대·진행 중 준비 상태가 새 개발 실행을 막을 수 있습니다.

React Fast Refresh는 기본적으로 꺼져 있습니다. Core 운영자가 NEXIA_SANDBOX_HMR_ENABLED=true로 설정하고 캐시된 설정을 갱신한 뒤 장시간 실행 중인 Core 워커를 재시작하면 켤 수 있습니다. 변경은 새 작업공간 페이지부터 적용되며, 기존 페이지를 새로고침하기 전에 작성 중인 내용을 저장하세요. CLI와 React SDK가 기능을 지원하고 샌드박스 Core에 개발용 자산이 제공되며, App이 Vite 7.3.x와 기본 nexiaAppConfig(import.meta.url) 설정을 사용하면 React Fast Refresh를 사용할 수 있습니다. 호환되는 컴포넌트와 스타일 변경은 작업공간을 다시 불러오지 않고 반영되며 컴포넌트 상태를 유지할 수 있습니다. 사용자 지정 설정이나 미지원 버전은 기존 빌드 방식으로 동작합니다. 연결이 끊기거나 자동 반영할 수 없는 변경이 있으면 현재 작업공간이 유지됩니다. 명시적으로 작업공간을 새로고침하기 전에 작성 중인 내용을 저장하세요. 프런트엔드와 백엔드를 함께 변경한 경우에는 일치하는 백엔드 변경이 완료된 뒤 프런트엔드를 노출합니다.

앱 하나의 개발 실행을 현재 플랫폼 런타임으로 교체하려면 앱 폴더에서 nexia dev restart를 실행하거나 프로젝트에서 nexia dev restart --app <폴더 또는 키>를 실행하세요. 해당 앱의 nexia dev를 켜 두거나 다시 시작한 뒤 Development ready를 기다립니다. 교체 중에는 앱을 잠시 사용할 수 없으며 소스와 데이터는 유지됩니다. 2분 안에 종료가 확인되지 않으면 Developers에서 앱 상태를 확인하세요. 이 명령에는 CLI 0.2.0-alpha.51과 호환되는 Core·Manager 버전이 필요합니다.

nexia dev에서 전체 앱, 저장한 Config Apps 또는 개별 앱을 최대 20개까지 선택합니다. nexia dev config로 기본 선택을 저장하고, --app을 반복하면 실행할 앱을 명시할 수 있습니다.

인증

login은 현재 폴더의 프로젝트로 재인증하거나 프로젝트 ID를 묻습니다. 계정 전체가 아닌 프로젝트 단위 브라우저 승인입니다. connect는 인증과 폴더 연결을 수행하며 create project도 승인을 포함합니다. --no-browser는 승인 URL만 출력합니다. logout은 폴더 연결·데이터를 지우지 않습니다. status가 현재 인증과 폴더가 다른지 알려주며 앱을 다른 프로젝트로 자동 이동하지 않습니다.

공식 플랫폼은 https://developers.nexia.to 입니다. 플랫폼 개발자는 NEXIA_ENDPOINT 환경 변수로 login, connect, create project의 서버를 지정할 수 있습니다. 이미 연결된 프로젝트의 재인증은 저장된 서버를 우선합니다. 서버가 바뀌면 기존 인증은 해제됩니다. .nexia/와 전역 CLI 인증 파일을 공유하거나 커밋하지 마세요.

환경 준비

setup --devtools는 CLI 전용 디렉터리에 생성 도구를 설치/업데이트합니다. 전역 Composer는 바꾸지 않습니다. setup은 macOS Homebrew PHP·Composer도 설치/업그레이드할지 묻고 실행 계획을 확인받습니다. 기존 런타임 버전이 바뀔 수 있으며 이번 개편은 업그레이드 정책을 변경하지 않습니다. Linux/Windows는 필수 도구를 직접 설치한 뒤 --devtools를 사용합니다. --dry-run은 설치하지 않으며 셸 시작 파일도 자동 편집하지 않습니다.

DB 작업과 제출

프로젝트 루트 또는 그 안의 앱 폴더에서 nexia db access를 실행하세요. 개인 샌드박스의 모든 관리형 앱 데이터를 읽고 쓸 수 있는 계정 하나를 제공합니다. CLI는 공인 IPv4 등록과 서버·게이트웨이 적용 상태, 경과 시간을 표시한 뒤 접속 정보와 앱 이름 → 스키마 이름 목록을 출력합니다. Core 내부 데이터·DB 관리·앱 테이블 구조 변경 권한은 포함하지 않습니다. 구조 변경은 해당 앱의 nexia db migrate 등 기존 CLI 명령으로 수행합니다.

DBeaver에는 PostgreSQL 연결 하나를 만들고 출력된 Host, Port, Database, User, Password를 입력하세요. SSL은 verify-full로 설정하며 출력된 호스트명을 유지합니다. App schemas 목록에서 원하는 앱의 스키마를 찾으세요. 신규 관리형 앱 스키마는 dev_people_<고유번호>처럼 앱 이름을 포함하고, 기존 스키마 이름과 데이터는 그대로 유지합니다. 이 기능은 PC에 PostgreSQL을 설치하거나 로컬 DB를 생성하지 않습니다.

계정은 앱 실행 계정과 분리되어 nexia dev 종료나 앱 재실행으로 교체되지 않습니다. 샌드박스가 유효하고 개발 권한이 유지되는 동안 같은 연결을 사용합니다. 새 앱 스키마는 서버 동기화에서 자동 허용되며, 이후 마이그레이션이 생성하는 테이블에도 데이터 권한이 자동 적용됩니다. DBeaver의 스키마 목록을 새로 고치면 됩니다. 새 앱마다 db access를 다시 실행할 필요는 없습니다. PC의 로컬 PostgreSQL을 사용하는 앱 데이터는 이 서버 연결에 포함되지 않습니다.

전체 앱을 감시하는 nexia dev는 다른 터미널에서 nexia create app으로 만든 새 앱을 자동 발견합니다. 특정 앱만 선택했다면 새 앱을 포함해 실행 대상을 다시 선택하세요. 앱 등록과 DB 준비 후 해당 앱 폴더에서 nexia db migrate를 실행합니다.

SQL 클라이언트의 공인 IP가 바뀌면 nexia db access --ip <공인 IPv4>, 개인 샌드박스의 외부 SQL 접속을 해제하려면 nexia db access --revoke를 사용하세요. 해제는 이 SQL 계정의 연결에 적용되며 앱 데이터는 보존됩니다. 샌드박스 만료·삭제 또는 개발 권한 회수 시 접속도 종료됩니다. 기존 앱별 접속 정보는 새 샌드박스 계정 정보로 바꿔야 합니다. 새 CLI에는 대응 Core와 DB 게이트웨이 업데이트가 필요합니다.

앱 데이터를 개발자 PC의 PostgreSQL에 두는 경우에는 첫 실행 전에 개발 앱에 로컬 PostgreSQL 사용하기를 따르세요. nexia db local이 앱 전용 로컬 DB를 준비하고 nexia dev가 터널을 유지합니다. 이미 Nexia 제공 DB에 할당된 앱의 데이터를 자동으로 이전하지 않습니다.

nexia dev는 소스를 감시하지만 migration과 초기화를 자동 실행하지 않습니다. 실행해 둔 채 migration 파일을 작성하고, 준비되면 다른 터미널의 앱 폴더에서 nexia db migrate를 실행하세요. 현재 로컬 소스를 업로드해 해당 리비전에 고정하고 완료까지 기다린 뒤, 소스 감시가 재개됩니다. 새 앱은 관리자 검토 없이 첫 명시적 migration을 기다립니다. 개발 migration은 롤백·수정·재실행할 수 있습니다. 게시된 파일은 유지하고 새 파일로 버전을 업그레이드하세요.

프로젝트 루트에서는 전체 앱을 순차 실행하고, --app=people 또는 앱 폴더에서는 해당 앱만 실행합니다. 한 앱이 실패해도 나머지는 계속 실행합니다. db status는 앱 Provider 부팅 없이 파일별 적용 여부·배치·변경·누락·중단 진단과 마지막 명령을 표시합니다. db rollback은 마지막 배치(--step·--batch로 범위 지정), db reset은 전체 down(), db refresh는 롤백 후 migrate, db fresh는 선택한 개발 스키마 삭제 후 migrate입니다. 데이터 삭제 가능성이 있는 명령은 선택한 앱을 한 번에 확인합니다. db seed는 앱 Seeder(--class로 클래스 지정), db seed <key>는 기존 fixture를 실행합니다. refresh·fresh는 --seed를 지원합니다. migrate·rollback·reset의 --pretend는 값을 가린 SQL을 미리 보여 주며 migrate --step은 파일마다 배치를 기록합니다. dev를 켜 둔 채 오류를 수정하고 명령을 다시 실행하세요. 비트랜잭션 실패는 앱 DB의 남은 객체를 직접 확인·수정한 뒤 재실행합니다. 소스 변경이나 fresh는 필수가 아닙니다. submit은 개발 DB 상태가 아닌 게시 이력을 검사합니다. 매니페스트 자체가 로드되지 않으면 적용 기록과 일반 마이그레이션 경로를 표시하고 목록이 불완전함을 알립니다. 새 명령은 CLI·Core·Manager의 대응 버전이 필요합니다.

Git으로 코드와 버전 태그를 먼저 커밋·push한 뒤 check, submit --tag v1.0.0을 실행하세요. 저장소 미연결 시 대화형 실행은 Developers 승인을 안내합니다. 자동화에서는 미리 연결해야 합니다. CLI가 커밋·태그·push하지 않습니다. 제출은 심사 요청이며 배포·설치와 다릅니다. 반환된 ID로 상태를 확인하고, 취소·재시도는 서버 상태와 권한에 따라 허용됩니다. 코드 변경에는 새 태그가 필요합니다. Core 0.8.172부터 서버가 재시도 가능 상태로 확인한 일시적인 플랫폼 검사 오류도 기존 재시도 명령으로 다시 검증할 수 있습니다. 원래 검사 기록은 보존하며 필수 검사를 다시 수행합니다.

테스트 데이터 실행

앱이 선언한 테스트 데이터만 실행할 수 있습니다. nexia dev를 켜 두고 nexia db migrate를 먼저 완료한 뒤, 앱 폴더에서 실행하세요. 아래 첫 명령은 데이터를 선택하고 실행 확인을 받습니다.

코드 예시
Shell
nexia db seed
nexia db status

키를 알고 있다면 nexia db seed <key>를 사용합니다. 명령이 completed까지 기다린 뒤 앱에서 생성된 데이터를 확인하세요. queued·running은 기다리고, 실패한 명령은 원인을 수정한 뒤 명시적으로 다시 실행합니다. 같은 데이터를 반복 실행할 때의 효과는 앱의 fixture 구현을 확인하세요.

컬럼 변경은 데이터 모델과 마이그레이션의 적용 순서를 따릅니다.

자동화·오류 복구

옵션의미
--no-interactive질문 없음·필수값 누락/대상 모호 시 오류
--yes최종 변경 확인 생략·필수값/권한/브라우저 승인 대체 아님
--dry-run설치·생성 명령에서 변경 계획만 표시
--json상태·DB·제출 명령의 구조화 출력·질문 없음
--request-idDB·제출의 동일 요청 복구용 UUID

TTY가 없으면 질문하지 않습니다. 선택 설정은 문서화된 기본값을 사용합니다. dry-run은 변경이 없어 최종 확인을 생략합니다.

코드 예시
Shell
nexia make resource Note --app people --label-ko '메모' --no-interactive --yes
nexia submit --app people --tag v1.0.0 --no-interactive --yes --json
nexia submit status <submission-id> --json

JSON 모드의 stdout에는 결과 또는 error.code, error.message만 출력하고 진단은 stderr로 보냅니다. 종료 코드는 0 성공/접수, 1 작업 실패, 2 입력 오류, 130 취소입니다. 0이어도 비동기 작업 완료를 의미하지 않습니다.

인증 만료는 프로젝트에서 login으로 복구합니다. 프로젝트 생성 응답을 잃으면 같은 폴더·이름으로 재시도합니다. 대기 중 승인을 이어가며 다른 프로젝트를 임의 생성하지 않습니다. 소스·빌드 오류는 원인을 수정하고 dev를 다시 시작하세요. DB 초기화를 복구 수단으로 사용하지 마세요.

이전 명령에서 전환

init → create app, create-project → create project, link-project → connect, make:resource/page → make resource/page, validate → check, submissions → submit으로 변경합니다. 뒤에 앱 경로를 붙이지 않고 해당 폴더에서 실행하거나 --app을 사용합니다. --without-navigation/record는 --no-navigation/record로 바뀝니다.

수동 등록·sync·runtime·repository·doctor 명령, browser 템플릿, DB reset/references, 다른 앱 fixture, 리소스 카탈로그, 서명 생성기, Filament 옵션, Runtime 이미지 검사, 로컬 MCP는 공개 CLI에서 제외합니다. 플랫폼·SDK·내부 구현 자체를 삭제하지는 않습니다. 수동 단발성 스냅샷과 nexia를 통한 MCP 실행은 더 이상 제공되지 않으며 동기화는 dev에서 수행합니다. 제외된 모든 기능에 Console 대체 기능이 있다고 가정하지 마세요. PHP devtools의 기존 서명·Filament 생성기는 유지합니다.

CLI 개발 시 독립적으로 설치한 생성기를 NEXIA_DEVTOOLS_PATH로 지정할 수 있습니다. 생성·검사 대상 앱 내부의 실행 파일은 허용하지 않습니다. 지원 요청에는 재현 절차와 버전을 포함하고 인증 정보·고객 데이터는 제외하세요: Developer Support.

Core 테이블을 참조하는 관계는 Core 식별자를 외래키로 참조하기에서 허용 목록과 저장 전 검사를 확인하세요.

내 앱에서 db seed <key>를 실행하기 전에 fixture 선언과 재실행 확인을 따라 개발 데이터를 준비하세요.

문서 조회

nexia docs는 로그인·프로젝트 없이 실행합니다. --locale en|ko로 언어를, --json으로 구조화된 출력을 선택합니다. 작업별 계약·원문 언어·검색 제한과 SDK 버전 확인은 코딩 도우미와 함께 작업하기를 참고하세요.

최근 제출과 터미널 탐색

nexia submit status를 ID 없이 실행하면 앱·태그·상태·제출 시간으로 최근 제출을 선택합니다. ↑/↓와 Enter로 선택하고 Esc/Ctrl+C로 취소합니다. 선택 화면에서 이전 페이지도 조회할 수 있습니다. nexia submit list --page 2는 ID를 포함한 목록을 출력합니다. 앱 폴더에서는 해당 앱, 프로젝트 루트에서는 해당 프로젝트를 조회합니다. 비대화형 환경의 ID 없는 status는 목록을 반환합니다. 자동화의 cancel/retry는 명시적인 ID와 확인이 필요합니다. 도움말은 작업별로 묶고 선택 항목을 강조합니다. NO_COLOR/TERM=dumb에서는 색상을 끄며 파이프·JSON 출력은 일반 텍스트를 유지합니다.

connect는 폴더 연결과 인증, login은 해당 폴더의 CLI 재인증입니다. stop은 추적 중인 로컬 watcher·preview 서버를 종료합니다. logout은 CLI 인증을 해제하며 로컬 프로세스, 프로젝트 연결, 샌드박스·워크스페이스 데이터, 브라우저 로그인은 유지합니다. 둘 다 원하면 stop 후 logout을 실행하세요. 재개할 때는 필요한 경우 login, 이어서 status, dev를 실행합니다. 이전 인증으로 시작한 watcher는 재시작합니다. 인증이 만료되어도 status/logout은 사용할 수 있습니다. 이 명령들은 샌드박스나 워크스페이스를 삭제하지 않으며 해당 생명주기는 Developers에서 별도로 관리합니다.

소스 반영 실패 후 개발 재개

CLI 0.2.0-alpha.47에는 준비 오류 상세 표시와 실행 종료 확인 후 복구가 포함돼 있습니다. nexia update 후 nexia --version을 확인하고 같은 앱 선택으로 nexia dev를 실행하세요. 소스 반영이 실패하면 실행·업데이트 ID, 소스 버전, 전체 오류와 제공된 상세 주소를 보관합니다. 기존 개발 명령에 --verbose를 추가하면 해당 실패 구간을 자세히 확인할 수 있습니다.

Core 0.8.163과 호환 런타임에서는 이전 반영이 안전하게 되돌려졌으면 다음 소스 저장을 진행할 수 있습니다. 반영 결과가 불확실하거나 Waiting for execution to stop 상태라면 서버 확인이 필요합니다. 로컬 watching이나 오래된 로컬 기록 제거만으로 준비 완료를 판단하지 마세요. DB 초기화·SDK 요구 버전 하향·정리 보호 장치 제거는 필요하지 않습니다. Development ready, 후속 소스 반영, 권한이 있는 앱 조회를 확인한 뒤 복구 여부를 판단합니다.

GitHub 준비 오류 상세와 발행된 CLI 릴리스를 참고하세요.

원본 위치: docs/developers/content/ko/getting-started/cli.md