VibeAround

VibeAround란?

VibeAround는 어디서든 지원되는 AI 코딩 에이전트에 접근할 수 있는 로컬 에이전트 코딩 인터페이스입니다. 인기 IM 플랫폼을 통한 채팅과 브라우저 기반 웹 터미널이라는 두 가지 주요 인터페이스를 제공하며, 동일한 로컬 워크스페이스를 기반으로 하여 휴대폰, 카페 노트북, 데스크톱 셸 어디서든 작업을 계속할 수 있습니다.

프로젝트에는 구성 및 서비스 관리를 위한 경량 데스크톱 앱(Tauri로 제작)이 포함되어 있습니다. 에이전트와 IM 채널은 필요 시 활성화할 수 있는 플러그인으로 구현되며, 기본 연결성과 세션 동작은 일관된 프로토콜과 내장 터널링을 통해 처리됩니다.

주요 기능

• 어떤 IM에서도 로컬 AI 에이전트와 채팅: Telegram, Slack, Feishu/Lark, Discord에서 에이전트에 DM을 보내 채팅 인터페이스를 통해 코드 작성 및 명령 실행.
• tmux 호환 웹 터미널: 브라우저에서 완전한 셸 사용; 모바일에서는 화면상 명령 패드로 ESC, Ctrl/화살표 입력 등을 한 번 탭으로 접근. tmux와 연동해 브라우저 종료 후에도 세션 유지.
• 양방향 세션 핸드오버: /handover와 /pickup으로 터미널과 IM 간 라이브 코딩 세션 이동, 전체 컨텍스트 보존.
• 대화 중 에이전트 전환: VibeAround 재시작 없이 지원 에이전트 변경(예: /switch claude, /switch codex, /switch cursor).
• 단기 링크를 통한 라이브 프리뷰: 개발 서버의 렌더링된 Markdown/HTML 공유, 휴대폰이나 브라우저에서 링크 열기.
• 터널 및 자격 증명 설정 마법사: 설정 마법사가 에이전트 종속성 설치, 채널 자격 증명 입력, 터널 제공자 선택으로 수동 구성 최소화.

VibeAround 사용 방법

1. 프로젝트 빌드 및 실행 (로컬 개발용): cd src, 그 다음 bun install, bun run prebuild, bun run dev.
2. 데스크톱 앱 실행: 첫 실행 시 설정 마법사 열림.
3. 에이전트 및 채널 선택: 마법사 지시에 따라 사용할 에이전트 활성화 및 IM 채널 자격 증명 구성.
4. 터널링 설정: 마법사가 터널 백엔드 선택으로 웹 터미널과 라이브 프리뷰를 토큰 게이트 공용 URL로 접근 가능하게 함.
5. 작업 시작: IM 클라이언트 열어 에이전트에 DM으로 채팅 기반 코딩, 또는 브라우저에서 웹 터미널 사용. 필요 시 /handover와 /pickup으로 인터페이스 간 라이브 세션 핸드오버.

리포지토리에 명시된 필수 조건은 Rust 1.82+, Node.js 20+, Bun 1.1+; macOS에서는 xcode-select --install도 실행해야 함.

사용 사례

• 여행 중 IM에서 코딩: Telegram/Slack/Feishu/Discord에서 명령 전송 및 코딩 출력 직접 채팅 수신으로 개발 지속.
• 대여 노트북에서 터미널 작업: 카페 기기에서 브라우저 기반 웹 터미널 열기; tmux 사용으로 브라우저 종료 후 세션 지속.
• 휴대폰과 터미널 간 전환: 웹 터미널에서 세션 시작 후 핸드오버 명령으로 IM(또는 그 반대)에서 동일 컨텍스트로 계속.
• 작업별 다른 에이전트 사용: Telegram에서 한 에이전트 실행 중 Slack에서 다른 에이전트 사용, 또는 제공 /switch ... 명령으로 대화 중 전환.
• UI/콘텐츠 검증을 위한 빠른 프리뷰 공유: 단기 링크로 렌더링된 Markdown/HTML 또는 개발 서버 출력 게시, 휴대폰에서 확인.

자주 묻는 질문

• VibeAround가 지원하는 AI 코딩 에이전트는? 리포지토리에 Claude Code, Gemini CLI, Codex CLI, Cursor CLI, Kiro CLI, Qwen Code 지원 명시; stdio를 통해 ACP(Agent Client Protocol)로 통신 처리.

• VibeAround가 IM 플랫폼에 어떻게 연결하나? 각 IM 채널은 필요 시 로드되는 독립 Node.js 플러그인으로 실행. 채널 인증 세부 사항은 플랫폼별 상이(예: 봇 토큰, 앱 자격 증명, QR 코드 로그인), 설정 마법사가 입력 도움.

• “세션 핸드오버”는 실제로 무엇인가? /handover와 /pickup 명령으로 웹 터미널과 IM 간 라이브 코딩 세션 이동, 전체 컨텍스트 보존.

• 웹 터미널과 라이브 프리뷰 URL에 접근 제어가 필요한가? 네. 리포지토리에 노출 URL이 토큰 게이트 적용 명시: 공개 접근 가능하나 오직 사용자만 열 수 있음.

• 세션 지속을 위해 tmux가 필요한가? 문서에 웹 터미널을 tmux와 연동해 브라우저 종료 후 세션 유지 가능하다고 명시.

대안

• CLI 에이전트를 직접 사용하는 로컬 터미널 워크플로: 자체 터미널에서 에이전트 CLI를 사용할 수 있지만, IM 통합, 웹 터미널 인터페이스, 또는 채팅과 터미널 간 내장 세션 핸드오버를 얻을 수 없습니다.
• 웹 기반 AI 코딩 어시스턴트: 브라우저 기반 어시스턴트는 어디서든 일관된 인터페이스를 제공할 수 있지만, 로컬 에이전트 프로세스 연결과 채팅 및 터미널 간 동일한 워크스페이스 유지에 대한 VibeAround의 초점을 따라잡지 못합니다.
• 플랫폼 봇을 통한 채팅 기반 코딩 (세션 핸드오버/웹 터미널 없음): IM 봇 접근 방식은 에이전트 출력을 채팅으로 가져올 수 있지만, VibeAround에서 설명된 것과 같은 양방향 핸드오버와 웹 터미널 경험을 제공하지 않을 수 있습니다.
• 범용 터널링 + 자체 웹 터미널: 터널링과 브라우저 내 터미널 설정을 사용하면 원격 액세스를 근사할 수 있지만, VibeAround의 플러그인 아키텍처와 핸드오버 명령어를 사용하는 대신 에이전트/세션 관리를 직접 조립하고 유지해야 합니다.