vladzima/kodeck

Claude Code를 위한 오픈 소스 IDE (Open-source IDE). 채팅, 터미널, git worktree 관리가 가능한 멀티 프로젝트 워크스페이스를 모두 브라우저에서 사용할 수 있습니다.

npx kodeck-app

Node.js 22 이상 버전과 활성화된 Claude Code 인증 (OAuth)이 필요합니다. https://kodeck.localhost:1355에서 열립니다.

.

멀티 프로젝트 워크스페이스 (Multi-project workspace)— 단일 UI에서 여러 저장소(repos)와 워크트리(worktrees)를 관리합니다.
채팅 세션 (Chat sessions)— 스트리밍 응답, 도구 호출 시각화 (tool call visualization), 권한 프롬프트, 사고 지표 (thinking indicators).
터미널 세션 (Terminal sessions)— 채팅과 함께 xterm.js 기반의 완전한 PTY 터미널을 제공합니다.
Git worktree 관리 (Git worktree management)— 워크트리 생성, 전환, 풀(pull), 푸시(push); 브랜치 및 PR 탐색.
설정 브라우저 (Config browser)— 프로젝트 전반의 CLAUDE.md, 기술 (skills), 훅 (hooks), MCP 서버, 에이전트 (agents) 조사.
세션 지속성 (Session persistence)— 채팅 기록 및 세션이 재시작 후에도 유지됩니다.
검색 (Search)— 모든 세션 및 도구 출력 결과에서 검색 가능.
데스크톱 앱 (Desktop app)— Tauri를 통한 네이티브 macOS 앱 (선택 사항)

저장소를 클론하고 의존성을 설치하세요:

git clone https://github.com/vladzima/kodeck.git
cd kodeck
pnpm install

개발 서버를 시작하세요 (클라이언트 + 서버 동시 실행):

pnpm dev

이 명령은 3001번 포트에서 서버를, 5173번 포트에서 클라이언트를 시작합니다. http://localhost:5173 을 여세요.

개발 중 더 나은 https://kodeck.localhost URL을 사용하려면:

npm install -g portless
portless proxy start --https
pnpm dev:local

apps/
client/ React + Tailwind 프론트엔드 (Vite)
server/ Node.js WebSocket 백엔드 (node-pty)
...

명령 (Command)	설명 (Description)
pnpm dev	개발을 위한 클라이언트 + 서버 시작
pnpm dev:local	https://kodeck.localhost를 위해 portless를 사용하는 동일한 명령
pnpm ready	모든 항목에 대해 포맷팅 (format), 린트 (lint), 테스트 (test) 및 빌드 수행
pnpm build:npm	kodeck npm 패키지 빌드
pnpm tauri:dev	개발 모드에서 네이티브 데스크톱 앱 실행
pnpm tauri:build	네이티브 macOS 데스크톱 앱 빌드

이 프로젝트는 통합 툴체인으로 Vite+ (vp)를 사용합니다. vp lint, vp fmt, vp test를 사용하세요. oxlint, vitest 또는 포맷터를 직접 실행하지 마십시오.