Installing cys-terminal on Windows

English summary#

Grab cys_<version>_x64-setup.exe from Releases — a self-contained NSIS installer bundling the daemon, CLI, and runtime (Git Bash + Python), so there is nothing else to install first.
PE version-resource, manifest, and icon embedding reduce SmartScreen/Defender friction, but the build is still unsigned, so a first-run warning can appear — click "More info" → "Run anyway".
Running the app once finishes onboarding automatically: pack install, Claude Code role-awakening hook registration, and logon auto-start (Task Scheduler) — no manual cys init-pack needed.
Optional always-on mode: cys daemon install (Windows Task Scheduler, ONLOGON).

Note: The step-by-step instructions below are reproduced verbatim from the project's Korean-language install documentation. An English summary is given first.

From docs/INSTALL.md#

Windows#

코어(named pipe·ConPTY·DSR)는 검증 완료(docs/WINDOWS_VALIDATION.md). GUI 앱(Tauri)의 Windows 빌드는 별도 트랙입니다. 현재 Windows 배포는 CLI+데몬(MSI/ZIP) 중심입니다.

🧑 A. MSI 설치파일 [HUMAN]#

아키텍처에 맞는 파일 실행: cys-0.2.0-windows-x64.msi 또는 ...-arm64.msi.
설치 시 cys.exe·cysd.exe가 PATH에 등록됩니다.
cys list — 데몬이 없으면 자동 기동됩니다.

🧑 B. ZIP (수동) [HUMAN]#

cys-0.2.0-windows-x64.zip을 풀고 폴더를 PATH에 추가하거나, 그 폴더에서 직접 cys.exe 실행.

🧑 C. 상시 가동 (선택) [HUMAN]#

cys daemon install     # 로그온 시 자동 기동 (작업 스케줄러 ONLOGON)
cys daemon status
cys daemon uninstall

※ Windows는 작업 스케줄러에 사망-시-재기동이 없어, CLI 자동기동이 이를 보완합니다.

From docs/INSTALL-Windows-KR.md (dedicated Windows walkthrough)#

버전 0.6.0 확정(오너 승인). 정식 발행은 master가 수행합니다. WINFIX(Windows 배포본 전 에러 수정) 반영본 — 이전 안내(MSI·수동 init-pack)와 크게 달라졌습니다.

한눈에 (WINFIX로 바뀐 점)#

자기완결 설치파일 하나면 끝입니다. Git·Python을 따로 설치하지 않아도 됩니다 — 설치파일 안에 필요한 실행환경(Git Bash + Python)이 함께 들어 있습니다.
처음 실행하면 자동으로 준비됩니다. 예전에는 설치 후 사람이 cys init-pack을 직접 쳐야 했지만, 이제 앱을 처음 켜면 팩 설치·역할 각성 hook 등록·로그온 자동기동 등록이 자동으로 됩니다.
그래서 "너는 마스터다" 부트스트랩과 ＋부서 버튼이 순정 Windows에서도 바로 동작합니다 (이 두 가지가 이전 버전에서 안 되던 증상이었고, 이번에 고쳤습니다).

설치 (사람)#

릴리스에서 cys_0.6.0_x64-setup.exe (NSIS 설치파일)를 내려받아 실행합니다.
- 내려받는 곳: GitHub 릴리스 idoforgod/cys-terminal (오너이 발행한 정식본).
- 설치파일 안에 실행환경이 동봉돼 있어(설치 폴더 \runtime\ 아래 Git Bash·Python) 인터넷이나 추가 설치 없이 첫 기동에 바로 작동합니다.
설치가 끝나면 cys 앱을 한 번 실행합니다.
- 이때 자동으로: ①운영 팩(%USERPROFILE%\.cys\pack) 설치 ②Claude Code 역할 각성 hook 등록 ③로그온 시 데몬 자동 기동 등록(작업 스케줄러). — 사람이 따로 명령을 칠 필요가 없습니다.
앱에서 터미널 pane을 열고 cys list를 실행해 데몬이 뜨는지 확인합니다(자동 기동됩니다).

확인 (설치가 잘 됐는지)#

dir %USERPROFILE%\.cys\pack               (팩이 설치돼 있으면 파일들이 보입니다)
type %USERPROFILE%\.claude\settings.json  (SessionStart hook 이 bash 로 등록돼 있으면 정상)
schtasks /Query /TN cysd                  (로그온 자동기동이 등록돼 있으면 정상)

pane에서 Claude Code를 켜고 **"너는 마스터다"**라고 입력하면 역할 부트스트랩이 뜹니다(자동 각성).
＋부서 버튼을 누르면 새 부서가 생성됩니다(부서별 독립 폴더·로그로 격리됩니다).

수동으로 다시 준비하고 싶을 때 (선택)#

자동 온보딩이 어떤 이유로 빠졌다면 아래를 직접 실행할 수 있습니다(모두 여러 번 실행해도 안전).

cys.exe init-pack        (팩 + 역할 각성 hook 재설치)
cys.exe daemon install   (로그온 자동기동 재등록)
cys.exe daemon status    (등록 상태 확인)

참고#

이전 안내에 있던 MSI(cys-0.2.x) 는 구버전 방식입니다. 현재 소비자 배포본은 위 NSIS setup.exe(runtime 동봉) 이며, 로컬 개발 폴더 dist-win\의 옛 파일은 배포본이 아닙니다.
부서·업데이트·역할 노드 등 세부 동작은 앱 내 안내와 docs/INSTALL.md(공통)를 함께 참고하세요.

이 문서는 WINFIX(T4-prep) 산출입니다. 버전 0.6.0 확정 · 정식 발행(태그·공개)은 master가 수행합니다.

Note: Quick-start boot steps, uninstall, and the environment variable reference are shared across platforms and live on the macOS install guide.

See also: macOS install guide · User Manual · Back to Overview

Updated Aug 14, 2026