Kaku: AI 코딩을 위해 태어난 터미널

AI 코딩 시대에 터미널은 어떤 모습이어야 할까. tw93이 그 답을 제시합니다. WezTerm을 기반으로 AI 코딩에 특화된 터미널 — 그게 Kaku입니다.

설정 파일 한 줄 없이 JetBrains Mono가 깔려 있고, 명령이 실패하면 AI가 해결책을 제안합니다. 67MB에서 40MB로, 40% 작아진 바이너리는 즉시 시작합니다.

왜 주목해야 하는가

기존 터미널의 문제는 명확했습니다.

• 설정의 지옥: 폰트, 색상, 플러그인 — 처음 시작하는 데만 반나절
• AI 도구 분산: Claude Code, Codex, Gemini CLI — 설정이 제각각
• 무거운 실행: WezTerm 원본은 67MB, 시작하는 데 1-2초

Kaku는 이 문제를 “설정 없이” 해결합니다.

핵심 철학: Zero Config, AI-First

Zero Config의 의미

Kaku를 설치하고 실행하면 이미 완성된 상태입니다.

기본 적용된 것들:

• JetBrains Mono 폰트 (프로그래밍 특화)
• macOS 최적화 폰트 렌더링
• 다크/라이트 테마 (자동 전환)
• Visual Bell (소리 없는 알림)
• Copy on Select (선택 즉시 복사)

.config/kaku/config.lua를 열어볼 필요가 없습니다. 열어도 비어 있습니다.

40% 작은 바이너리

어떻게 가능했을까요?

• 불필요한 기능 제거: Wayland, X11, 복잡한 멀티플렉서
• 레이지 로딩: 필요한 모듈만 그때그때 로드
• macOS 전용 최적화: 크로스 플랫폼 코드 제거

결과: Apple Notarized된 40MB 바이너리가 즉시 시작합니다.

Kaku Assistant: AI가 실패를 구원한다

터미널에서 가장 답답한 순간은 언제인가요. 명령이 실패했을 때입니다.

$ git push origin main
fatal: 'orgin' could not be read remotely.

오타인데, 초보자는 알 수 없습니다. Kaku는 여기서 개입합니다.

작동 방식

1. 명령 실행 → 실패 (종료 코드 ≠ 0)
2. Kaku가 에러 메시지 분석
3. AI가 해결책 제안
4. Cmd + Shift + E로 즉시 적용

실제 시나리오:

$ npm run dev
sh: npm: command not found

[Kaku Assistant]
Node.js가 설치되지 않았거나 PATH에 없습니다.
해결 방법:
1. brew install node
2. 또는 nvm use default

[적용하려면 Cmd + Shift + E]

지원하는 AI 백엔드:

• Claude (Anthropic API)
• GPT (OpenAI API)
• 로컬 LLM (Ollama)

컨텍스트 인식

Kaku Assistant는 단순히 에러 메시지를 복사해서 AI에 보내지 않습니다.

• 현재 디렉토리의 프로젝트 타입 인식
• 최근 명령 히스토리 컨텍스트 활용
• 환경 변수 상태 파악

그래서 더 정확한 해결책을 제시합니다.

AI Tools Config: 모든 AI 코딩 도구를 한 곳에

AI 코딩 도구가 너무 많아졌습니다. 각각 설정 파일이 다르고, API 키 관리도 따로입니다.

Kaku는 이를 통합합니다.

지원 도구

통합 설정

Kaku 설정 한 곳에서 모든 AI 도구를 관리합니다:

-- ~/.config/kaku/ai.lua (자동 생성됨)

ai_tools = {
  claude_code = {
    api_key = "sk-ant-...",
    model = "claude-sonnet-4-20250514"
  },
  codex = {
    api_key = "sk-...",
    model = "codex-2"
  },
  gemini_cli = {
    api_key = "AIza...",
    model = "gemini-2.5-pro"
  }
}

장점:

• API 키 한 번 입력 → 모든 도구에서 사용
• 모델 설정 중앙 관리
• 사용량 추적 통합

큐레이션된 쉘 스위트

Kaku는 터미널만 제공하는 게 아닙니다. AI 코딩에 유용한 CLI 도구들을 큐레이션합니다.

기본 포함

이 도구들이 설치 과정 없이 바로 사용 가능합니다.

Smart Jump (z)

z 명령으로 자주 가는 디렉토리에 즉시 이동합니다.

$ z project    # ~/projects/my-project로 이동
$ z config     # ~/.config로 이동
$ z blog       # ~/blog로 이동

Kaku는 방문한 디렉토리를 학습하여 더 스마트하게 이동합니다.

History Peek

위아래 화살표로 히스토리를 탐색할 때, 미리보기가 표시됩니다.

$ █
  ┌─ History Preview ─────────────┐
  │ git push origin main          │
  │ npm run test                  │
  │ claude "fix the auth bug"     │
  └───────────────────────────────┘

전역 핫키: 언제든 Kaku

Cmd + Opt + Ctrl + K — 어느 앱에 있든 Kaku가 즉시 나타납니다.

macOS 시스템 레벨에서 동작합니다. 브라우저를 보다가, IDE를 쓰다가, 이메일을 쓰다가 — 어디서든.

사용 시나리오:

1. VS Code에서 코딩 중
2. 빠른 Git 명령 필요
3. Cmd + Opt + Ctrl + K
4. Kaku가 슬라이드 인
5. 명령 실행
6. Esc로 원래 작업으로 복귀

IDE를 떠날 필요가 없습니다. Kaku가 찾아옵니다.

Visual Bell과 Copy on Select

작지만 중요한 디테일들입니다.

Visual Bell

터미널에서 에러가 나면 보통 “삑” 소리가 납니다. 옆 사람에게 민폐입니다.

Kaku는 화면을 살짝 깜빡입니다. 소리 없이 에러를 알립니다.

Copy on Select

텍스트를 선택하면 자동으로 복사됩니다. Cmd+C가 필요 없습니다.

$ echo "Hello, Kaku!"
Hello, Kaku!  ← 드래그만 하면 클립보드에 복사됨

기술 아키텍처

WezTerm 포크

Kaku는 WezTerm을 포크했습니다. WezTerm 선택 이유:

• Rust로 작성됨: 안정성, 성능
• GPU 가속: 부드러운 렌더링
• 확장성: Lua 설정 시스템

Kaku가 추가한 것:

• AI 통합 레이어
• macOS 전용 최적화
• 큐레이션된 기본 설정

Apple Notarized

모든 Kaku 릴리스는 Apple Notarization을 통과합니다.

• 보안 검증 완료
• macOS Gatekeeper 경고 없음
• 안심하고 설치 가능

macOS 전용

Kaku는 macOS에서만 작동합니다. 이게 단점일 수도 있지만, 장점입니다.

• macOS에 집중한 최적화
• 코드베이스 단순화
• 빠른 릴리스 사이클

빠른 시작

Homebrew (권장)

brew tap tw93/kaku
brew install kaku

수동 설치

1. 릴리스 페이지에서 다운로드
2. Kaku.app을 Applications로 드래그
3. 실행

첫 실행

# Kaku 실행
open -a Kaku

# 전역 핫키 테스트
# Cmd + Opt + Ctrl + K

# AI 도구 설정 확인
kaku config

Kaku vs 다른 터미널

언제 Kaku를 쓸까

추천

• AI 코딩 도구를 자주 사용 — Claude Code, Codex, Gemini CLI 등
• 터미널 설정에 시간 낭비하고 싶지 않음 — Zero Config
• macOS 사용자 — 최적화된 경험
• 빠른 터미널 원함 — 40MB, 즉시 시작

비추천

• Linux/Windows 사용자 — macOS 전용
• 고급 커스터마이징 필요 — Zero Config가 제약일 수 있음
• tmux/Screen 의존 — Kaku는 자체 멀티플렉싱 없음

마치며: AI 코딩 시대의 터미널

Kaku는 단순히 “또 다른 터미널”이 아닙니다. AI 코딩 워크플로우를 염두에 두고 설계된 목적 지향적 도구입니다.

핵심 가치 정리

1. Zero Config — 설치 후 바로 사용
2. AI-First — 실패한 명령을 AI가 구원
3. 통합 — 모든 AI 코딩 도구를 한 곳에
4. 경량 — 40% 작은 바이너리, 즉시 시작
5. 전역 접근 — Cmd + Opt + Ctrl + K

tw93은 “AI 코딩을 위해 태어난 터미널”이라고 말합니다. 그 말 그대로입니다.

빠른 시작

brew tap tw93/kaku
brew install kaku
kaku

설정할 것 없습니다. 그냥 쓰면 됩니다.

🔗 관련 정보

• GitHub: https://github.com/tw93/kaku
• 개발자: tw93 (淘宝前端)
• 기반 프로젝트: WezTerm
• 라이선스: MIT