Zeno

Codex 스타일 데스크톱 UI

사이드바, 세션 작업 공간, 입력 영역으로 구성된 데스크톱 인터페이스를 제공하며, 데스크톱 환경이 자체 설정 파일을 새로 만들지 않고 pi의 환경을 그대로 사용합니다.

실제 워크스페이스 복원

제품 실행 시 사용자의 실제 HOME과 pi의 에이전트 디렉터리(~/.pi/agent)를 그대로 사용하며, 마지막 워크스페이스를 데스크톱 환경설정에서 복원합니다. 시작할 때마다 임시 워크스페이스가 생성되지 않습니다.

격리 실행 옵션

임시 홈과 픽스처 워크스페이스, 가짜 모델로 실행하는 격리 모드(ZENO_ISOLATED=1)를 지원하여, 기존 pi 환경을 건드리지 않고도 UI를 시험해볼 수 있습니다.

세션 콘텐츠 전용 미리보기

Electron 없이 브라우저에서 세션 타임라인 렌더링만 확인하는 데모 모드를 제공하여, 렌더러 변경 사항을 빠르게 반복해 볼 수 있습니다.

다중 플랫폼 패키징

Windows용 NSIS 설치 프로그램(.exe), macOS용 DMG와 zip, AppImage와 .deb 패키지를 빌드하며, electron-updater를 위한 latest.yml / latest-mac.yml / latest-linux.yml 피드를 함께 생성합니다.

설치·시작·기본 사용

Windows 사용자는 winget을 이용해 다음 명령으로 설치할 수 있습니다.

• winget install –id aletheics.Zeno –exact

소스에서 직접 개발 환경을 구성하려면 Node.js 22.19 이상과 pnpm 11.15.1을 준비한 뒤 저장소를 클론하고 의존성을 설치합니다. electron:install 스크립트는 플랫폼에 맞는 Electron 43 런타임을 내려받습니다.

• pnpm install
• pnpm electron:install

개발 모드 실행과 빌드 진입점은 앱별로 분리되어 있습니다. 데스크톱 앱의 개발 모드는 Vite 개발 서버(http://localhost:5173)를 통해 React HMR을 제공하고 백엔드 변경 시 Electron을 자동으로 재시작합니다.

• 데스크톱 개발: pnpm dev (핫 리로드), pnpm run dev:once (단발성 실행), pnpm build:desktop (빌드만)
• 랜딩 페이지 개발: pnpm dev:landing (http://localhost:5174), pnpm build:landing, pnpm preview:landing
• 전체 워크스페이스 빌드: pnpm build

CI와 동일한 검사(린트·타입·테스트)는 다음 명령으로 수행합니다.

• pnpm check (린트·타입·포맷)
• pnpm check:types (린트·타입만)
• pnpm fmt (포맷 자동 수정)
• pnpm test

데스크톱 패키징은 다음 명령으로 플랫폼별 설치 프로그램을 만듭니다.

• pnpm package

결과물은 apps/desktop/release/app/ 경로에 생성되며, CI에서는 서명되지 않은 상태로 빌드됩니다.

활용 예시

실제 HOME을 그대로 사용하는 실행 모드를 통해, 개발자는 기존의 pi 설정과 세션을 그대로 이어 받아 데스크톱 UI로 작업을 이어갈 수 있습니다. 격리 실행 옵션(ZENO_ISOLATED=1)은 임시 홈과 픽스처 워크스페이스에서 동작을 검증하거나 UI를 시험해 볼 때 활용할 수 있습니다. 세션 콘텐츠 미리보기(demo:session-content)는 Electron 없이 세션 표시 로직만 빠르게 확인할 때 유용합니다.

제한·라이선스·확인사항

소스 코드는 MIT 라이선스로 배포되며, 자세한 내용은 저장소의 LICENSE 파일에서 확인할 수 있습니다. Renderer는 Node.js에 직접 접근하지 않고, 메인 프로세스가 Agent Host(utilityProcess)를 관리하지만 pi 도구나 확장을 직접 실행하지는 않습니다. Agent Host는 공개된 @earendil-works/pi-coding-agent SDK를 사용하며, Electron의 userData는 데스크톱 환경설정 전용으로 사용되고 별도의 에이전트 구성 계층을 만들지 않습니다. utilityProcess는 크래시 격리를 위한 것이지 보안 샌드박스가 아니며, 새로운 pi 홈에는 Zeno 패키지·리소스·사용자 설정이 자동으로 주입되지 않습니다. macOS에서 서명되지 않은 다운로드의 첫 실행 시 xattr -cr /Applications/Zeno.app 명령으로 Gatekeeper quarantine을解除할 수 있습니다.