프로젝트 소개

Kun은 로컬 우선(local-first) AI 에이전트 워크벤치로, AI를 '질문에 답하는 것'에서 '작업을 완료하는 것'으로 발전시키는 것을 목표로 합니다. 두 가지 주요 모드를 제공합니다: Code 모드는 소프트웨어 전달을 대상으로 하며, 동일한 작업 내에서 Design 캔버스를 제공합니다; Work 모드는 작성, 자료 정리, 문서 분석, 프레젠테이션 제작을 대상으로 합니다. 에이전트는 작업 공간 컨텍스트를 읽고, 계획을 수립하고, 도구를 호출하고, 파일을 수정하고, 검증을 실행하며, 작업 옆에 증거를 남깁니다. 데스크톱 GUI는 관찰, 검토, 프로세스 제어에 적합하고, 터미널 TUI는 키보드 중심의 집중 작업에 적합합니다. 둘 다 동일한 로컬 `kun serve` 런타임을 통해 스레드, 목표, 계획, 승인, 백그라운드 작업을 공유하며, 분리된 두 세션이 아닙니다. 주요 기능: - Code 모드: 프로젝트 컨텍스트, 파일 편집, 터미널, Git/Worktree, Diff, 테스트 및 검토. - Design 캔버스: 동일한 Code 작업 내에서 프로토타입, 디자인 시스템, Design → Code 컨텍스트를 축적합니다. - Work 모드: Markdown 편집, PDF/Office 문서 미리보기·인용·분석, 스프레드시트 분석, 개요에서 프레젠테이션 생성; Office 파일은 읽기 전용으로 유지됩니다. - 자동화: 예약 작업(Scheduled tasks), 루프(Loops), 훅(Hooks), MCP, 스킬(Skills), 설치 가능한 확장 기능. - 모델 연결: 구독, 플랜, API, OpenAI/Anthropic 호환 서비스 및 자체 호스팅 모델을 프로바이더 구성으로 연결할 수 있으며, 사전 설정은 ChatGPT/Codex, Claude, Gemini, Cursor, Ollama, DeepSeek, Kimi, GLM, Qwen, MiniMax, Xiaomi MiMo 등 생태계를 포함합니다. 작업 흐름: 목표 명확화 → 계획 수립 → 실행 및 협업 → 증거 확인 → 전달 또는 계속. 요구 사항과 계획은 기본적으로 프로젝트에 저장되어 버전 관리, 코드 검토, 이후 복구가 용이합니다. 로컬 우선은 세션, 기본 설정, 로그, 런타임 데이터가 기본적으로 로컬에 저장됨을 의미합니다; 클라우드 모델을 선택하면 프롬프트, 첨부 파일, 작업 컨텍스트가 선택한 프로바이더로 전송됩니다. 도구 권한, 민감한 작업, 확장 권한은 인터페이스에서 명확히 표시되며, 사용자가 승인 여부를 결정합니다. 설치 및 실행: GitHub Releases에서 macOS(.dmg/.zip, Apple Silicon/Intel), Windows(.exe, x64), Linux(.AppImage/.deb, x64) 설치 패키지를 다운로드할 수 있습니다. 소스에서 실행하려면 Node.js 22.19+, npm 및 최소 하나의 사용 가능한 모델 연결이 필요하며, 일반적인 명령어는 `npm run dev`, `npm run dev:tui`, `npm run typecheck`, `npm run lint`, `npm run test`, `npm run build` 및 각 플랫폼 패키징 명령어가 있습니다. 라이선스는 PolyForm Noncommercial License 1.0.0으로, 학습, 연구, 비상업적 용도로만 사용할 수 있습니다; 상업적 사용, 상업적 배포, SaaS/호스팅 서비스, 재판매 또는 상업 제품에 통합하려면 작성자의 별도 서면 승인이 필요합니다.