당신의 코드를 위한 Vibe Check를 만들었어요 (감자에서 실행됩니다 🥔)

Source: Dev.to

당신이 새벽 3시에 코드를 푸시하면서 어딘가에 // FIXME: 를 남겼다고 확신할 때 그 느낌, 알죠?
네, 우리 모두 그런 경험이 있습니다.

VibeCheck은 “미완성된 분위기”—TODO, 하드코딩된 비밀, 디버그 출력, 그리고 개발자의 절박함을 나타내는 다른 징후들을 스캔하는 고성능 Zig CLI 도구입니다. 런타임 의존성 없이 약 149 KB 크기의 단일 정적 바이너리로 빌드됩니다.

VibeCheck란?

• 미완성 또는 보안에 취약한 코드를 나타내는 패턴을 재귀적으로 스캔합니다.
• 정적 바이너리를 실행할 수 있는 모든 플랫폼(Linux, macOS, Windows)에서 동작합니다.
• node_modules 같은 블랙홀도 없고, 런타임도 없으며, 감자 🥔에서도 실행될 수 있는 작은 실행 파일입니다.

내장 팩: 핵심 분위기

위 항목 중 하나라도 발견되면 VibeCheck은 크게 경고합니다.

성능 및 크기

• 크기: ~149 KB (정적 링크, 스트립됨)
• 속도: 50 000 파일 규모의 모노레포를 < 1 초에 스캔
• 의존성: 없음

또한 선택적인 AI 모드가 포함되어 있어, 내장 MCP(Model Context Protocol) 서버를 통해 Claude Desktop 등 다른 LLM 도구와 통합할 수 있습니다.

사용법

사람이 읽기 쉬운 스캔

vibecheck .

샘플 출력

[WARN] Desperation Marker (FIXME)
  src/main.js:42:10
    | // FIXME: terrible hack, remove before launch

CI/CD 통합

분위기가 맞지 않으면 빌드를 실패하게 할 수 있습니다:

vibecheck . --json   # 기계가 읽을 수 있는 출력

GitHub Actions 주석을 원한다면 --github 옵션을 사용할 수도 있습니다.

특징

• ⚡ 번개처럼 빠름: 수천 개 파일을 밀리초 단위로 재귀 스캔합니다.
• 🪶 가벼움: ~149 KB 정적 바이너리, 의존성 제로.
• 📦 이식성: Linux, macOS, Windows용 단일 실행 파일.
• 🛡️ 검증된 안정성: 50 000 파일 규모의 “구글 수준” 모노레포에서 검증되었습니다.
• 🧩 모듈화: JSON 플러그인 시스템을 통해 커스텀 패턴 팩을 로드할 수 있습니다.
• 🤖 CI/CD 친화: 빌드 실패 시 비-제로 종료 코드, JSON 출력, GitHub Actions 지원.
• 🧠 AI 준비: LLM 통합을 위한 내장 MCP 서버.

설치

소스에서 빌드

# Requirements: Zig 0.13+ and Git
git clone https://github.com/copyleftdev/vibecheck.git
cd vibecheck
zig build -Doptimize=ReleaseSmall

생성된 바이너리는 zig-out/bin/vibecheck에 위치합니다.

사전 빌드 바이너리 (선택)

GitHub 저장소의 Releases 페이지에서 준비된 릴리스를 다운로드할 수도 있습니다.

라이선스

VibeCheck은 MIT License 하에 오픈 소스입니다.

View on GitHub – 별을 달아 주시고, 프로젝트에 적용해 보세요. “미완성” 분위기가 얼마나 심각한지 확인해 보시기 바랍니다.

행복한 코딩 되세요. 🤙