eneskirca/nodeterm

nodeterm – 공간적 터미널 및 AI 에이전트 관리자

개요 – nodeterm은 Electron으로 구축된 크로스 플랫폼 데스크톱(macOS, Linux, Windows) 및 서버 사이드 웹 앱입니다. 무한히 이동 및 확대/축소 가능한 캔버스 위에 노드를 생성할 수 있습니다. 각 노드는 실제 터미널(tmux 백엔드), AI 에이전트(Claude Code, Gemini, Copilot 등), 포스트잇, Monaco 기반 코드 에디터, diff 뷰, 또는 웹/비디오 임베드로 작동합니다. 모든 노드는 앱 재시작 후에도 유지되므로 셸은 계속 실행되고 AI 대화도 살아있습니다.

중요성 – 기존의 터미널 탭은 컨텍스트를 숨기지만, nodeterm은 각 세션을 라벨링, 그룹화, 링크 가능한 공간 객체로 변환합니다. 동일한 캔버스가 Trello 스타일의 칸반 보드로도 작동하며, 상태는 자체 호스팅 브라우저 서버나 iOS 컴패니언 앱에서 접근할 수 있습니다. 이를 통해 복잡한 멀티 프로세스 워크플로우(빌드 실행, 디버깅, AI 어시스턴트 프롬프트 등)를 시각화하고 관리하기가 더 쉬워지며, 특히 시각적 레이아웃을 선호하는 사용자에게 적합합니다.

주요 기능

• 노드 기반 캔버스 – 우클릭으로 터미널, AI 에이전트, 메모, 에디터, diff, 웹 임베드를 추가; 자유롭게 드래그, 줌, 라벨링 가능.
• 영구적 tmux 세션 – 노드 재마운트 및 기기 재부팅 후에도 터미널(프로세스 및 스크롤백 포함)이 계속 실행됨.
• AI 에이전트 – Claude Code 및 기타 모델 내장 지원; 에이전트는 실시간 상태 배지(RUNNING / NEEDS YOU)를 표시하고, 링크된 메모에서 컨텍스트를 읽으며, CLI를 통해 캔버스를 제어할 수 있음.
• 칸반 뷰 – ⌘⇧B로 전환; 각 노드는 카드로 표시되며, 하위 세션을 유지한 채 열 사이를 이동 가능.
• 원격 및 모바일 – QR 코드로 휴대폰 페어링; iOS 앱은 동일한 실시간 세션을 표시하고 에이전트 프롬프트에 응답 가능. "Server Edition"은 Linux 호스트에서 헤드리스로 실행되며 브라우저에서 접근 가능.
• 음성 받아쓰기 – ⌘⌥ (Ctrl+Alt)를 누른 상태에서 Whisper로 로컬에서 받아쓰기하여 터미널 프롬프트에 입력.
• Git 통합 – worktree 인식 그룹화, 전체 스테이징/커밋 UI, 선택적 GitHub-Issues-to-Kanban 동기화.
• 크로스 플랫폼 패키징 – .dmg, Homebrew cask, AppImage, .deb, .rpm, Windows 설치 프로그램 및 iOS 앱 제공.

일반적인 워크플로우

1. 새 프로젝트 열기 → 빈 캔버스 표시.
2. 우클릭으로 터미널 노드 배치; tmux 세션 생성.
3. AI 에이전트 노드(예: Claude Code)를 추가하고 컨텍스트가 포함된 포스트잇을 링크.
4. 칸반 뷰로 전환하여 에이전트 카드를 In Progress로 이동; 에이전트는 계속 실행됨.
5. iPhone을 페어링하고 QR 코드를 스캔하여 포켓 앱에서 세션 모니터링.
6. 에이전트가 NEEDS YOU 신호를 보내면 배지를 클릭하여 프롬프트에 응답하고, 배지가 녹색으로 변경됨.

획득 방법 – https://nodeterm.dev 에서 빌드된 바이너리를 다운로드하거나 Homebrew (brew install --cask nodeterm)를 통해 설치하십시오. 소스 코드는 Node 20+, tmux 및 표준 Electron 툴체인으로 빌드할 수 있습니다 (npm ci && npm run dist).

라이선스 – Business Source License 1.1 (BUSL-1.1).