jakemor/kanna

해결하는 문제

Kanna는 명령줄 인터페이스(CLI) 기반의 코드 생성 에이전트인 Claude Code와 Codex를 위한 그래픽 사용자 인터페이스(GUI)를 제공합니다. 터미널 기반의 경험을 아름다운 웹 기반 채팅 인터페이스로 전환하여, 여러 프로젝트를 쉽게 관리하고 에이전트의 진행 상황을 추적하며, 터미널에 계속 머물지 않고도 AI 코드 도구와 상호작용할 수 있도록 합니다.

작동 방식

Kanna는 Bun 기반 서버로 동작하며, React 기반 웹 프론트엔드와 로컬 에이전트 프로세스(Claude Agent SDK 또는 Codex App Server) 사이를 연결합니다. 실시간 통신을 위해 WebSockets를 사용하고, 이벤트 소싱 아키텍처를 통해 채팅 기록과 상태를 로컬 JSONL 로그에 지속적으로 저장합니다. 시스템은 모델 선택 및 추론 노력 제어를 처리하는 정규화 레이어를 통해 Claude, Codex, Cursor, Pi 등 여러 AI 제공업체를 조율합니다.

대상 사용자

Claude Code나 Codex와 같은 AI 코드 에이전트를 사용하지만, 채팅을 관리하고 에이전트의 계획을 검토하며 다양한 프로젝트 간 작업을 정리하기 위해 시각적 인터페이스를 선호하는 개발자들입니다.

주요 기능

• 다중 제공업체 지원: Claude, Codex, Cursor, Pi 간에 전환 가능하며, 각 제공업체별로 모델 및 추론 노력 설정이 가능합니다.
• 프로젝트 중심의 조직화: 사이드바에 실시간 상태 표시기와 드래그 앤 드롭 정렬 기능을 갖춘 프로젝트별 채팅 그룹화.
• 계획 모드: 에이전트의 계획을 실행하기 전에 검토하고 승인할 수 있습니다.
• 풍부한 렌더링: 도구 호출을 하이드레이트하고 접을 수 있는 도구 그룹 및 인터랙티브 프롬프트를 렌더링합니다.
• 로컬 프로젝트 자동 탐지: 기존 Claude 및 Codex 로컬 기록에서 프로젝트를 자동으로 탐지합니다.
• 내장된 Pi 에이전트: pi 코드 에이전트를 종속성으로 포함하여 별도의 로컬 설치가 필요하지 않습니다.