localci 0.1.0 공개, GitHub Actions를 푸시 전 로컬에서 점검

GitHub Actions 워크플로를 개발자 컴퓨터에서 미리 실행하는 오픈소스 도구 localci가 11일 0.1.0 버전으로 공개됐다. 프로젝트 공식 GitHub 릴리스와 문서에 따르면, 기존 CI 설정을 읽어 현재 운영체제에 맞는 작업을 로컬에서 실행하고 빌드 캐시를 재사용한다.

localci는 코드를 GitHub에 푸시하기 전 테스트와 검사 결과를 확인하는 데 초점을 맞췄다. 기본적으로 .github/workflows/ci.yml을 읽으며, 별도의 CI 설정을 새로 작성하지 않고 기존 저장소에서 작업 목록을 확인하거나 실행할 수 있다.

공식 호환성 문서는 셸 명령 실행 단계와 매트릭스, 작업 간 의존관계를 나타내는 needs, 환경변수와 작업 출력 등을 지원 대상으로 설명한다. 다른 운영체제가 필요한 작업은 건너뛰고 필요한 실행 환경을 계획에 표시한다. PostgreSQL이나 Redis 같은 서비스는 Docker 컨테이너로 띄울 수 있다.

0.1.0에는 변경된 입력을 기준으로 실행 범위를 줄이는 빠른 실행 모드가 포함됐다. localci run --fast는 변경과 무관한 빌드·테스트 단계를 제외하고, 같은 입력으로 이미 통과한 단계의 결과와 산출물을 재사용하며, 독립적인 작업을 병렬로 실행한다. 해석하지 못하는 명령은 생략하지 않고 실행하는 방식이다.

AI 코딩 에이전트와 연결하는 기능도 제공한다. localci skill install을 실행하면 Claude Code와 Codex 등 설치된 에이전트의 스킬 디렉터리에 사용 지침을 넣는다. 문서상 에이전트는 변경 내역과 실행 계획을 검토해 검사할 작업을 제안하고, 실행 후 실패한 단계의 로그를 확인하도록 설계됐다.

다만 로컬 실행을 GitHub Actions의 완전한 재현으로 볼 수는 없다. uses:로 지정한 액션과 재사용 워크플로는 실행하지 않으며, container: 설정도 반영하지 않고 호스트에서 단계를 실행한다. 실제 GitHub 러너와 도구 버전이 다르면 로컬에서 통과한 작업이 원격 CI에서는 실패할 수 있다.

프로젝트는 GitHub에 검사 결과나 상태를 등록하는 기능도 제공하지 않는다. 공식 문서는 GitHub CI를 최종 판단 기준으로 남겨두고, 리뷰를 위해 푸시하기 전에는 --fast 없이 한 차례 실행할 것을 권고한다. 따라서 반복적인 로컬 사전 검사에는 활용할 수 있지만, 원격 CI를 대체하는 도구는 아니다.

릴리스에는 Linux x64·arm64, macOS Apple Silicon·Intel, Windows x64용 바이너리가 제공된다. 라이선스는 MIT다.

출처: localci 공식 GitHub 릴리스
https://github.com/peters/localci/releases/tag/v0.1.0
localci 0.1.0 공식 README
https://github.com/peters/localci/blob/v0.1.0/README.md
localci 0.1.0 공식 호환성 문서
https://github.com/peters/localci/blob/v0.1.0/docs/compatibility.md