Station-Sciences/bot-crossing

해결하는 문제

Bot Crossing은 AI 코드 에이전트를 위한 시각적 관리 인터페이스입니다. 여러 리포지토리와 다양한 도구(허네스)에서 동시에 실행되는 여러 에이전트 스레드를 추적하는 문제를 해결하며, 전통적인 로그 목록 대신 에이전트 활동을 공간적으로 맵핑합니다.

작동 방식

이 도구는 Claude Code, Codex, Cursor 등의 AI 코드 에이전트 도구(이를 '허네스'라고 함)에서 로컬 세션 파일을 스캔합니다. 데이터 업로드나 계정 생성 없이 작동하는 소규모 어댑터 시스템을 사용하여 이러한 파일을 읽습니다.

각 리포지토리는 3D 맵상의 '존(zone)'으로 표현되며(Luna, Mars, Terra). 각 에이전트 세션은 '우주비행사'와 '건물'로 시각화됩니다. 에이전트의 상태(실행 중, 오류 발생, 사용자 입력 대기)는 우주비행사의 애니메이션과 배지(예: 읽지 않은 메시지에는 ?)로 표시됩니다. 사용자는 우주비행사를 클릭하여 해당 허네스 내에서 원래 스레드를 깊은 링크로 열 수 있습니다.

대상 사용자

다양한 프로젝트에서 여러 AI 코드 에이전트를 사용하며, 에이전트 워크플로우와 활성 세션 상태를 고수준의 공간적 시각으로 파악하고 싶은 개발자.

주요 기능

• 다중 허네스 지원: Claude Code, Codex, Cursor를 기본 지원.
• 로컬 우선: 로컬 파일만 읽고, 단일 로컬 colony.json 파일에만 씁니다. 데이터는 업로드되지 않습니다.
• 공간적 기억: 리포지토리 존은 '스티키(sticky)'로, 맵상에서 같은 위치에 고정되어 사용자가 프로젝트에 대한 정서적 맵을 형성하는 데 도움을 줍니다.
• 시각적 상태 표시: PBR 재질, HDR 조명, 특정 애니메이션을 사용해 에이전트 상태를 시각적으로 알립니다(예: 실행 중은 망치를 휘두르는 애니메이션, 비활성은 잠자는 애니메이션).
• 심층 통합: OS 수준의 깊은 링크를 사용해 3D 맵에서 바로 데스크톱 앱 또는 CLI 내 특정 에이전트 스레드로 이동할 수 있습니다.