터미널 코딩 에이전트를 모바일로 연결하는 오픈소스 도구 VibeAround 공개

실용적 조언

Claude Code를 외부에서 사용하고 싶다면 VibeAround를 설치하고 텔레그램 봇과 연동하여 활용 가능하다.
PC에서 작업 중 자리를 비워야 할 때 \handover 명령어를 사용하여 모바일로 세션을 즉시 옮길 수 있다.

섹션별 상세

터미널 환경의 제약 해결을 위해 로컬 데몬 기반의 중계 시스템을 구축했다. VibeAround는 사용자의 로컬 환경에서 실행되며 Claude Code, Gemini CLI 등 터미널 기반 에이전트를 텔레그램이나 디스코드 같은 IM 플랫폼에 연결한다. 이를 통해 사용자는 외부에서도 스마트폰을 이용해 프롬프트를 전송하고 실시간 스트리밍 응답을 받아볼 수 있다.

세션 핸드오버(Session Handover) 기능을 통해 기기 간 작업 연속성을 확보했다. 터미널에서 `\handover` 명령어를 입력하면 고유한 픽업 코드가 생성되며, 이를 모바일 메신저에 입력하면 기존의 모든 대화 문맥(Context)이 그대로 유지된 채 세션이 이전된다. 작업이 끝나면 다시 모바일에서 터미널로 세션을 되돌려 보내는 양방향 전환이 가능하다.

로컬 실행 구조를 채택하여 데이터 보안과 개인화된 워크플로우를 동시에 달성했다. 모든 프로세스는 사용자의 macOS 환경 내에서 로컬 데몬으로 작동하므로 외부 서버에 민감한 코드가 노출될 위험을 최소화했다. 현재 오픈소스로 공개되어 GitHub를 통해 누구나 코드를 검토하고 자신의 개발 환경에 맞춰 확장할 수 있다.

용어 해설

코딩 에이전트(Coding Agent): — 사용자의 지시에 따라 코드를 작성, 수정, 실행 및 디버깅하는 자율형 AI 도구이다. 터미널 환경에서 실행되며 파일 시스템 접근 및 명령어 실행 권한을 가져 복잡한 개발 작업을 수행한다.
데몬(Daemon): — 사용자가 직접 제어하지 않고 백그라운드에서 지속적으로 실행되며 특정 서비스를 제공하는 프로세스이다. 이 아티클에서는 코딩 에이전트와 메신저 플랫폼 사이의 통신을 중계하는 역할을 수행한다.
세션 핸드오버(Session Handover): — 한 기기에서 진행 중이던 작업 상태나 대화 문맥을 다른 기기로 그대로 이전하는 기술이다. 픽업 코드를 통해 터미널의 AI 대화 맥락을 모바일 메신저로 옮겨 끊김 없는 작업 흐름을 유지하게 한다.

언급된 도구

VibeAround추천링크

코딩 에이전트와 IM 플랫폼(텔레그램, 디스코드) 연결 및 세션 핸드오버 지원

Claude Code중립

Anthropic의 터미널 기반 AI 코딩 에이전트

Gemini CLI중립

Google의 터미널 기반 AI 도구

언급된 리소스

GitHubVibeAround GitHub Repository