원문 캡처 · github.com
원문 캡처 · github.com

Transit는 요청 추적, CI 실행, 코딩 에이전트 세션을 애니메이션 지하철 노선도로 바꾸는 로컬 도구 모음이다. 개발자는 지연이나 오류가 난 작업을 살펴보고, 대화형 HTML 페이지나 GIF·MP4로 공유할 수 있다.

노선은 작업 단위를, 역은 개별 이벤트를 나타낸다. 느린 작업에는 DELAY, 오류나 실패에는 SERVICE ALERT 표시가 붙는다. 공유용 페이지를 요청하면 실패한 항목을 이름에 담은 자체 포함 HTML 파일과 데이터에서 계산한 한 줄 판정이 만들어진다. 예를 들어 checkout-email-service-alert.html과 email failed after 671 ms: SMTP timeout · SERVICE ALERT · 23 hops처럼 출력된다. 파일은 Slack에 올릴 수 있으며, Slack 데스크톱과 iOS에서는 실패 지점과 세부 정보가 열린 상태로 대화형 페이지를 보여준다. 샘플 페이지에서 결과를 확인할 수 있다.

설치 명령 하나로 Claude Code, Codex, Cursor에 세 가지 스킬을 추가할 수 있다.

text
npx skills add israelvicars/transit -g -a claude-code -a codex -a cursor

개별 스킬은 설치 안내에서 선택할 수 있다. 설치 뒤에는 “이 OTLP 추적을 지하철 노선도로 애니메이션화해 줘” 또는 “마지막으로 실패한 GitHub Actions 실행을 보여 줘”처럼 요청한다.

request-transit은 OpenTelemetry/OTLP, Datadog, PostHog, AWS X-Ray, Grafana Tempo 데이터를 지원한다. 선택 기능인 계약(contracts) 계층은 사용자가 요청한 경우에만 로컬 서비스 코드를 읽어 예상 요청·응답 형식을 색인하고, 근거를 측면 패널에 표시한다. ci-transit은 저장된 GitHub Actions 실행을 읽거나 로컬 gh CLI로 읽기 전용 조회를 수행한다. agent-transit은 Claude Code, Codex, Cursor 세션을 다룬다.

에이전트 세션 지도는 기본적으로 도구 이름, 소요 시간, 상태, 대상의 파일명, 에이전트 출처만 보존한다. 프롬프트와 코드, 명령, 출력, 인수는 지도에 포함하지 않는다. 요청 추적과 CI 지도에서는 각각 서비스·스팬, 작업·단계가 노선과 역으로 표현된다.

  • 대화형 페이지는 오프라인으로 작동하며 네트워크 요청을 하지 않는다. 재생·탐색, 역별 세부 정보 확인, 목록 스크롤을 지원한다. --share로 만들면 첫 SERVICE ALERT에서 멈춘 상태로 열리고 한 줄 판정을 포함한다.
  • GIF는 문서·PR·피드용 반복 애니메이션이며, MP4는 입력이 같으면 매번 바이트 단위로 같은 영상이 만들어진다. 두 형식은 contact.png 요약 이미지도 생성한다.
  • GIF와 MP4 렌더링에는 로컬 Chromium과 ffmpeg가 필요하다. 최초 설정에서는 이미 설치된 도구를 재사용하고, 다운로드가 필요하면 먼저 알린다.

대화형 페이지에서 역·열차·노선을 클릭하거나 일시 정지한 뒤 N을 누르면 측면 패널이 열린다. 패널은 해당 지점까지의 경로, 클라이언트·서버 시작 시간과 지속 시간 및 자체 시간, 오류 메시지, 유형별 스팬 속성과 하위 스팬을 보여준다. 페이지를 만들 때 민감해 보이는 속성 키는 가려진다. --contracts를 사용했다면 예상 요청·응답 형식도 표시한다.

Transit는 로컬에서만 동작하며 텔레메트리, 추적, 분석 기능이 없고, 만들어진 페이지도 네트워크 요청을 하지 않는다. 요청 데이터와 추적 정보는 기기에 남는다. 공유 페이지에는 지도에 표시되는 정제된 추적 데이터만 담기며, --share는 엄격한 정제 수준을 적용하고 --no-scrub 옵션을 거부한다. Transit가 데이터를 업로드하지는 않지만, 파일을 공유할지는 사용자가 결정한다.

개발 환경에서는 npm test로 단위·어댑터·개인정보 보호·자체 포함 복사 테스트를 실행하고, npm run check로 테스트와 검증기 및 UI·네트워크 검사를 실행할 수 있다. 렌더링에는 로컬 브라우저와 ffmpeg가 필요하며, 선택적 가져오기 명령은 사용자의 백엔드나 GitHub 계정에 이미 설정된 인증 정보를 이용한다. 라이선스는 MIT이며, Transit는 MTA와 제휴하거나 MTA의 승인을 받은 제품이 아니다.

자료: Transit 저장소, 요청 추적 스킬 안내, CI 스킬 안내, 에이전트 스킬 안내, 요청 추적 애니메이션, CI 애니메이션, 에이전트 애니메이션, 측면 패널 이미지