Repolode
amantus-ai

amantus-ai/vibetunnel

어떤 기기에서든 브라우저로 셸 세션과 AI 코딩 에이전트를 실행하고 모니터링하며 제어할 수 있습니다.

스타
4,692
포크
335
열린 이슈
5
마지막 커밋
3개월 전

어떤 프로젝트인가요?

VibeTunnel은 호스트 머신의 터미널 세션을 웹 대시보드로 전달해, 휴대폰이나 태블릿, 다른 컴퓨터에서 장시간 실행되는 빌드와 테스트, AI 코딩 에이전트를 확인할 수 있게 합니다. 서버는 기본적으로 localhost의 4020 포트에서 실행되며, `vt` 명령으로 셸 명령을 감싸면 출력이 브라우저에 표시됩니다. 셸 별칭과 대화형 셸도 지원합니다.

Apple Silicon Mac용 네이티브 macOS 메뉴 막대 앱과, Node.js 22.12부터 24.x까지에서 Linux, Docker, 헤드리스 시스템용 npm 패키지(`vibetunnel`)를 제공합니다. Tailscale(비공개 또는 Funnel 기반 공개 모드), ngrok, Cloudflare quick tunnels, Pinggy, Pangolin을 통해 원격 액세스를 설정할 수 있습니다. 인증 방식으로는 시스템 계정, 환경 변수 자격 증명, Ed25519 SSH 키, 개발용 localhost 인증 우회가 있습니다.

그 밖에도 에이전트가 worktree에서 전환한 브랜치에 메인 checkout을 동기화하는 Git Follow Mode, 설정 가능한 터미널 제목 모드, 활동 표시기, asciinema 형식의 세션 녹화를 지원합니다. Windows는 아직 지원하지 않습니다.

핵심 기능

  • 01모든 세션을 한눈에 볼 수 있는 대시보드와 함께, 최신 웹 브라우저에서 터미널 세션을 표시합니다.
  • 02`vt` CLI로 명령을 감싸며, 셸 별칭과 함수도 확인해 실행합니다.
  • 03네이티브 macOS 메뉴 막대 앱과 Linux 및 헤드리스 호스트용 npm 패키지를 제공합니다.
  • 04시스템 계정, SSH 키, 환경 변수 자격 증명 등 다양한 인증 방식을 지원합니다.
  • 05Tailscale, ngrok, Cloudflare, Pinggy, Pangolin을 통한 원격 액세스를 지원합니다.
  • 06나중에 재생할 수 있도록 세션을 asciinema 형식으로 녹화합니다.

활용 사례

  • 자리를 비운 동안 휴대폰으로 장시간 실행되는 빌드나 테스트 스위트를 확인합니다.
  • 개발 머신에서 실행 중인 Claude Code 같은 AI 코딩 에이전트를 모니터링합니다.
  • SSH를 설정하지 않고 동료와 실시간 터미널 세션을 공유합니다.
  • 헤드리스 Linux 서버나 Docker 컨테이너에서 터미널 대시보드를 실행합니다.

빠른 시작

  1. 1

    npm 패키지를 전역으로 설치합니다

    npm install -g vibetunnel
  2. 2

    또는 Homebrew로 macOS 앱을 설치합니다

    brew install --cask vibetunnel
  3. 3

    브라우저에서 원하는 명령을 실행합니다

    vt pnpm run dev
  4. 4

    localhost의 4020 포트에서 대시보드를 엽니다

사용 전 알아둘 점

  • 네이티브 macOS 앱을 사용하려면 Apple Silicon Mac(M1 이상)이 필요합니다. Intel Mac은 지원하지 않습니다.
  • Windows는 아직 지원되지 않습니다.
  • iOS 앱은 개발 중이며 프로덕션 환경에서의 사용은 권장하지 않습니다.

토픽

자주 묻는 질문

vibetunnel은(는) 무엇인가요?
어떤 기기에서든 브라우저로 셸 세션과 AI 코딩 에이전트를 실행하고 모니터링하며 제어할 수 있습니다. VibeTunnel은 호스트 머신의 터미널 세션을 웹 대시보드로 전달해, 휴대폰이나 태블릿, 다른 컴퓨터에서 장시간 실행되는 빌드와 테스트, AI 코딩 에이전트를 확인할 수 있게 합니다. 서버는 기본적으로 localhost의 4020 포트에서 실행되며, `vt` 명령으로 셸 명령을 감싸면 출력이 브라우저에 표시됩니다. 셸 별칭과 대화형 셸도 지원합니다.
vibetunnel은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
vibetunnel은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
vibetunnel은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. vibetunnel의 마지막 커밋은 2026년 8월 5일입니다.
vibetunnel은(는) 어디에 사용할 수 있나요?
자리를 비운 동안 휴대폰으로 장시간 실행되는 빌드나 테스트 스위트를 확인합니다. 개발 머신에서 실행 중인 Claude Code 같은 AI 코딩 에이전트를 모니터링합니다. SSH를 설정하지 않고 동료와 실시간 터미널 세션을 공유합니다. 헤드리스 Linux 서버나 Docker 컨테이너에서 터미널 대시보드를 실행합니다.
vibetunnel는 어떻게 설치하나요?
npm 패키지를 전역으로 설치합니다: npm install -g vibetunnel 또는 Homebrew로 macOS 앱을 설치합니다: brew install --cask vibetunnel 브라우저에서 원하는 명령을 실행합니다: vt pnpm run dev localhost의 4020 포트에서 대시보드를 엽니다
vibetunnel은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/amantus-ai/vibetunnel

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트