CLI로 Neopress 사용하기
CLI 설치와 로그인, 대상 사이트 지정부터 페이지 초안 작성과 발행 확인까지 차례로 진행합니다.
Neopress CLI를 사용하면 터미널이나 AI 코딩 환경에서 사이트를 관리할 수 있습니다. 설치된 버전의 명령어 안내를 확인하고, 작업마다 대상 사이트를 명시하는 방식으로 시작하세요.
설치하고 로그인하기
Node.js 24 이상이 필요합니다. 공개 CLI 패키지를 설치하거나 최신 버전으로 업데이트한 뒤 버전을 확인합니다.
pnpm add -g @neopress/cli@latest
neopress --version
neopress login
neopress whoami로그인 명령은 브라우저를 열고 로컬 콜백으로 인증 결과를 받습니다. CLI는 세션을 저장하고 필요할 때 갱신합니다. 로컬 콜백을 사용할 수 없는 원격 터미널이라면 neopress login --manual을 실행하고 안내에 따라 콜백 URL을 해당 터미널에 붙여넣으세요.
개발자 도구는 Launch부터 사용할 수 있으며, Launch 권한이 적용되는 유효한 체험 기간도 포함합니다. 로그인한 계정이 해당 사이트에 접근할 수 있어야 하고, 각 명령은 계정에 부여된 작업 권한도 확인합니다.
대상 사이트 확인하기
neopress sites list
neopress --site 123 sites current
neopress --site 123 sites get
neopress --site 123 pages list123은 내 사이트 목록에서 확인한 ID로 바꾸세요. --site에는 사이트 ID나 핸들을 넣을 수 있으며 해당 명령 한 번에만 적용됩니다. sites current는 로컬 설정에서 어떤 사이트가 선택되는지 보여줍니다. 실제 사이트 정보와 접근 가능 여부는 sites get으로 확인합니다.
같은 프로젝트에서 반복 작업한다면 .neopressrc.json 파일에 {"siteId":123}을 저장할 수 있습니다. 대상 사이트는 --site, NEOPRESS_SITE_ID, 가장 가까운 프로젝트 설정, neopress sites use로 저장한 전역 사이트 순서로 결정됩니다. 여러 사이트를 동시에 작업할 때는 프로젝트별 설정이 유용합니다.
사용 가능한 명령어 확인하기
neopress guide
neopress guide --json
neopress pages create --help
neopress entries publish --help사이트, 페이지, 레이아웃, 컬렉션, 콘텐츠, 폼, 에셋, 리디렉션, 분석, 템플릿 관련 명령을 제공합니다. 도움말에 표시되더라도 별도 관리자 권한이 필요한 명령이 있으므로 실제 사용 권한은 구분해야 합니다. 다른 프로그램이나 AI 도구에 결과를 전달할 때는 --json을 사용하세요.
페이지 초안 만들고 검토하기
Neopress 런타임 규칙을 따르는 페이지 컴포넌트를 about.tsx로 저장한 뒤 다음 명령으로 초안을 만듭니다.
neopress --site 123 pages create --path /about --title About --tsx ./about.tsx반환된 페이지 ID를 다음 명령에 사용하세요. 아래의 456은 예시 ID입니다.
neopress --site 123 pages get 456
neopress --site 123 pages compile 456
neopress --site 123 publish preview컴파일은 페이지 코드를 검증합니다. 발행 미리보기는 반영할 변경 목록을 보여주므로, 대시보드에서 실제 화면도 함께 확인하세요. --i18n, --query-config 같은 JSON 옵션은 JSON 문자열이나 @file.json을 받습니다. --tsx에는 @ 없이 일반 파일 경로를 넣습니다.
검토한 변경 사항 발행하기
neopress --site 123 publish이 명령은 대상 사이트의 발행 대기 중인 변경을 반영합니다. 같은 사이트에 남아 있는 다른 페이지나 레이아웃 변경도 포함될 수 있습니다. CMS 콘텐츠 초안은 entries publish로 별도 발행해야 합니다. 현재 CLI를 통한 사이트 발행에는 소유자 또는 관리자 계정이 필요합니다. 성공 후에는 실제 페이지 주소를 열어 내용과 링크, 레이아웃을 확인하세요.
이후 수정할 때는 같은 --site 옵션과 함께 pages update 456 --tsx ./about.tsx를 실행하고 컴파일과 검토를 반복합니다. 저장된 로컬 로그인 정보를 지우려면 neopress logout을 실행하세요.