CodeNomad – AI 기반 코딩 콕핏

이것은 무엇인가 – CodeNomad는 OpenCode.ai의 신경 코드 생성 엔진인 OpenCode V2 위에서 동작하는 데스크톱 및 브라우저 애플리케이션입니다. 개발자가 여러 프로젝트를 관리하고, 긴 AI 기반 대화를 유지하며, UI를 벗어나지 않고 Git 워크트리를 사용할 수 있는 완전한 기능의 작업 공간을 제공합니다.

핵심 기능

기능	제공 내용
프로젝트 및 창	각각 자체 탭 바, 초안, 파일 첨부 및 레이아웃 복원 기능이 있는 별도의 데스크톱 창.
세션 및 기록	중첩된 AI 채팅 세션, 긴 대화를 탐색할 수 있는 타임라인, 모든 메시지에 대한 전체 텍스트 검색.
Git 워크트리 지원	UI에서 직접 워크트리 생성, 전환, 이동; 터미널을 열지 않고 diff 및 커밋 기록 보기.
풍부한 대화	Markdown, 코드 블록, diff, 도구 결과 이미지, 보조 질문을 위한 `/btw` 명령.
파일 처리	드래그 앤 드롭, 붙여넣기 또는 파일 선택; `@` 참조로 프로젝트 파일을 채팅에 삽입.
원격 액세스	모든 머신에서 CodeNomad 서버를 실행하고 HTTPS(비밀번호 보호)로 연결. 선택적 원격 제어는 OpenTunnel 릴레이를 통해 휴대폰이나 다른 컴퓨터를 연결하여 포트 포워딩을 피함.
SideCars	외부 웹 도구(VS Code 서버, 터미널, 사용자 지정 서비스)를 CodeNomad 내부의 탭으로 임베드.
에이전트 기반 브라우저 미리보기	AI 에이전트가 Electron 또는 Windows-Tauri에서 웹 미리보기를 열고 자동으로 검사.
음성 I/O	프롬프트를 받아쓰고 모델의 응답을 듣기.
사용자 지정 가능한 UI	명령 팔레트, 알림, 라이트/다크 테마, 다국어 패널 및 구성 가능한 패널.

시작하기

데스크톱 클라이언트 (Electron 또는 Tauri)

Releases 페이지에서 macOS, Windows 또는 Linux용 적절한 아카이브를 다운로드합니다.
설치합니다 (deb, AppImage, ZIP 또는 Windows 설치 프로그램). 번들에는 Node.js가 포함되어 있어 추가 런타임이 필요하지 않습니다.
첫 실행 시 CodeNomad를 기존 OpenCode V2 실행 파일로 지정하거나 설정 마법사가 설치하도록 합니다.
폴더를 열고 모델 제공자를 연결한 후 세션을 시작합니다.

서버 모드 (브라우저 전용)

npx @neuralnomads/codenomad --password "my-pwd" --launch

https://localhost에서 UI를 제공하는 로컬 Node.js 서버를 실행합니다. 원격 브라우저의 경우 --host 0.0.0.0을 추가합니다.
인증은 비밀번호 기반이며, 자체 서명된 TLS 인증서가 자동으로 생성됩니다.

개발 빌드

git clone -b dev https://github.com/NeuralNomadsAI/CodeNomad.git
cd CodeNomad
npm ci --workspaces --include=optional
npm run dev   # Electron 개발 호스트
# 또는 Tauri 셸의 경우 npm run dev:tauri

사전 요구 사항

OpenCode V2 (≥ 2.0.7, 2.0.21 권장) – 실제로 코드를 생성하는 AI 엔진.
Git – 워크트리 기능에 필요; 백엔드의 PATH에 있어야 합니다.
Node.js 24 LTS – 서버 및 소스에서 빌드하는 데 필요 (데스크톱 설치 프로그램에 번들됨).

작업 공간 확장

SideCars를 사용하면 로컬 웹 서비스(예: VS Code Server, ttyd 터미널)를 탭으로 임베드할 수 있습니다. Preferences → SideCars에서 이름, 포트, 프로토콜 및 경로 접두사 처리를 구성합니다.
플러그인 (전역 또는 프로젝트 범위)은 UI에서 활성화하여 사용자 지정 도구를 추가할 수 있습니다.

문제 해결 주요 사항

macOS 공증: xattr -dr com.apple.quarantine …로 격리 속성을 제거합니다.
Wayland + NVIDIA의 Linux Tauri: WebKitGTK DMA-BUF 렌더러를 비활성화합니다 (WEBKIT_DISABLE_DMABUF_RENDERER=1).

배후는 누구인가?

Neural Nomads (GitHub 조직 NeuralNomadsAI)가 개발하고 MIT 라이선스로 배포합니다.

CodeNomad는 OpenCode 엔진을 완전한 기능의 IDE 같은 콕핏으로 전환하여 코딩, 채팅, Git 관리를 한 곳에서 할 수 있게 합니다.

NeuralNomadsAI/CodeNomad