<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/zuke-build/zuke/raw/master/assets/logo-white.png" />
<img width="400px" alt="Zuke" src="https://github.com/zuke-build/zuke/raw/master/assets/logo.png" />
</picture>
Deno 및 TypeScript를 위한 코드 우선(code-first), 강력한 타입(strongly-typed)의 빌드 자동화 시스템입니다.
사용자의 빌드와 지속적 통합(CI)은 하나의 타입이 지정된 파일이며, 에이전트가 이를 실행할 수 있습니다.
<p align="center">
<a href="https://github.com/zuke-build/zuke/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/zuke-build/zuke/actions/workflows/ci.yml/badge.svg" /></a>
<a href="https://github.com/zuke-build/zuke/actions/workflows/release.yml"><img alt="Release" src="https://github.com/zuke-build/zuke/actions/workflows/release.yml/badge.svg" /></a>
<a href="https://codecov.io/gh/zuke-build/zuke"><img alt="커버리지" src="https://codecov.io/gh/zuke-build/zuke/branch/master/graph/badge.svg" /></a>
<a href="https://scorecard.dev/viewer/?uri=github.com/zuke-build/zuke"><img alt="OpenSSF Scorecard" src="https://api.scorecard.dev/projects/github.com/zuke-build/zuke/badge" /></a>
<a href="https://www.bestpractices.dev/projects/14036"><img alt="OpenSSF Best Practices" src="https://www.bestpractices.dev/projects/14036/badge" /></a>
<a href="https://github.com/marketplace/actions/zuke-build"><img alt="GitHub Marketplace" src="https://img.shields.io/github/v/release/zuke-build/zuke?filter=%21%2A-%2A&label=Marketplace&logo=github&color=2ea44f" /></a>
<a href="https://jsr.io/@zuke/core"><img alt="JSR" src="https://jsr.io/badges/@zuke/core" /></a>
<a href="https://jsr.io/@zuke/core"><img alt="JSR 점수" src="https://jsr.io/badges/@zuke/core/score" /></a>
<a href="./LICENSE"><img alt="라이선스: MIT" src="https://img.shields.io/badge/license-MIT-yellow.svg" /></a>
<a href="https://deno.com/"><img alt="Deno용으로 빌드됨" src="https://img.shields.io/badge/Deno-2.x-000?logo=deno&logoColor=white" /></a>
</p>
Zuke를 사용하면 빌드를 TypeScript 클래스로 정의할 수 있습니다. 각 타겟(target)은 클래스 필드이며, 타겟들은 문자열이 아닌 this.x를 통해 서로 참조하므로, 이름 변경은 리팩토링(refactor) 작업이 되고 오타는 컴파일 오류가 됩니다. Zuke는 이 단일 파일로부터 의존성 그래프를 해결하고, 순서대로 실행하며, CI YAML 파일을 생성하고, 전체 내용을 AI 에이전트가 사용할 수 있는 타입 지정 도구로 노출합니다. .NET을 위한 NUKE에서 영감을 받았습니다. 런타임 종속성이 없습니다.
타입 지정 빌드를 위해 5분
1. CLI 설치 — 원하는 것을 선택하세요. 모든 경로는 동일한 CLI이며 완전히 지원되므로, 바이너리에는 Deno가 미리 필요하지 않습니다. 설치를 참조하세요.
JSR을 통해 (모든 OS에서 Deno 사용):
denovo install -A -g -n zuke jsr:@zuke/cli
Homebrew로 (macOS, Linux):
brew install zuke-build/tap/zuke
Chocolatey로 (Windows):
2. 프로젝트 설정 및 실행 — 설치한 방식에 관계없이 다음을 수행합니다:
zuke setup
zuke
zuke generate-ci
zuke generate-ci는 빌드에 한 줄이 필요합니다. 다음은 스캐폴딩된 샘플 타겟을 실제 작업으로 대체한 후의 전체 파일입니다:
<!-- check -->
import { Build, cicd, run, target } from "@zuke/core";
import { DenoTasks } from "@zuke/deno";
...
zuke test는 lint를 실행한 다음 test를 실행합니다. zuke --list는 모든 타겟과 해당 설명, 의존성을 출력합니다. zuke graph --output=html은 그래프를 그립니다. 그리고 워크플로우 파일은 실행할 때마다 재생성되고 CI에서 검증되므로, YAML이 빌드와 어긋날 일이 없습니다.
<p align="center">
<img src="https://github.com/zuke-build/zuke/raw/master/assets/demo.svg" alt="Zuke in action: scaffold a build, list targets, run the gate" width="760" />
</p>
package.json 스크립트, Makefile 또는 pyproject.toml 태스크가 이미 있습니까?
zuke import를 사용하면 이를 각 태스크별 타겟을 가진 빌드(Python의 경우 build.py, 아니면 build.ts)로 변환합니다. 자세한 내용, 런처, 그리고 더 긴 첫 번째 빌드는 **Getting started**를 참조하세요.
실제 것을 만져보는 것을 선호하십니까? examples/에는 6개의 클론 가능한 프로젝트가 포함되어 있습니다. 여기에는 Deno 라이브러리 게이트, CI 전용으로 생성된 프로젝트, Node 앱, 라이브러리 릴리스 루틴, 타겟으로 변환된 셸 스크립트, 그리고 로컬에서 실행되는 카나리아 배포(canary rollout)가 포함되며, 각 프로젝트는 자체 폴더에서 zuke CLI를 통해 실행할 수 있습니다.
세 가지 짧은 레시피는 작은 프로젝트가 가장 먼저 원하는 것을 다룹니다:
셸 스크립트 교체하기,
CI를 생성하고 YAML 편집 중단하기, 그리고
작은 라이브러리 릴리스하기.
왜 Zuke를 사용해야 하는가 (Why Zuke)
- 타입이 지정되고 리팩토링에 안전한 의존성. 타겟들을 "clean"이 아닌
this.clean으로 연결합니다. 타겟 이름을 변경하면 모든 참조가 함께 이동하며, 오타는 런타임 오류(runtime surprise)가 아니라 컴파일 오류(compile error)로 처리됩니다.
- CI YAML을 다시 작성할 필요가 없습니다. 빌드 내에서
cicd({ provider: "github" })를 사용하여 파이프라인을 선언합니다. 이때 프로바이더(provider)만 필수 필드입니다. Zuke는 GitHub Actions, GitLab CI, Azure Pipelines 또는 Bitbucket YAML을 생성합니다. fanOut: true는 모든 타겟을 dependsOn을 미러링하는 needs: 엣지로 연결된 자체 작업(job)으로 만듭니다. 이는 실행할 때마다 재생성되며, 커밋된 파일이 변경되었을 경우(drifted) generate-ci --check가 CI를 실패시킵니다. 푸시하기 전에 로컬에서 정확히 동일한 타겟들을 zuke ci로 실행합니다.
- 에이전트가 빌드를 실행하도록 하세요.
zuke mcp는 Model Context Protocol을 통해 빌드를 제공합니다. 에이전트는 타겟 목록을 나열하고, 그래프를 읽은 다음, npm run what?처럼 추측하는 대신 타입이 지정된 매개변수와 함께 하나를 실행합니다. zuke setup --mcp는 첫날부터 클라이언트 등록을 작성합니다.
zuke --list --json과 생성된 llms.txt는 정적 대응물이며, agent skills는 Claude Code, Codex, Gemini CLI가 올바른 방식으로 build.ts를 작성하도록 가르칩니다.
- 순수 TypeScript. 빌드 로직은 일반적인 비동기(async) 함수이며 전체 에디터 지원을 갖추고 있어 맞춤형 DSL(Domain Specific Language)이 필요 없습니다.
@zuke/core/shell의 $ 태그 템플릿은 합리적인 기본값으로 프로세스를 실행하며 주입 방지(injection-safe) 기능이 있어, 아무도 건드리지 못하는 scripts/*.sh까지 대체합니다.
- 모든 도구를 위한 타입이 지정된 래퍼. 72개의 패키지: 작은 코어, CLI, 그리고 각 도구별
*Tasks 객체(Deno, npm, pnpm, Bun, Docker, Kubernetes, Terraform, Vite, Playwright, GitHub, Claude Code 및 기타)를 포함하며, 이들의 설정 람다(settings lambdas)는 실제 플래그와 일치합니다. Packages를 참조하세요.
- 작고 명시적입니다. 타겟을 발견하고(Discover targets), 그래프를 구축하며(build a graph), 정렬하고, 실행합니다(run). 기본적인 빌드를 위해 배울 마법이나 플러그인이 없습니다 — plugin contract는 필요할 때 사용할 수 있습니다.
deno task, npm 스크립트, Make, Nx, Turborepo, Dagger 대비 기능 매트릭스는 **How Zuke compares**를 참조하세요.
Zuke를 사용하는 곳
프로덕션 환경에서 Zuke를 운영하는 팀:
<a href="https://payhawk.com">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/zuke-build/zuke/raw/master/assets/users/payhawk-white.svg" />
<img width="170px" alt="Payhawk" src="https://github.com/zuke-build/zuke/raw/master/assets/users/payhawk.svg" />
</picture>
</a>
귀사에서도 Zuke를 사용하고 계신가요? 저희가 기꺼이 목록에 추가해 드리고 싶습니다 — assets/users/에 로고와 이 섹션의 항목을 추가하는 풀 리퀘스트(pull request)를 열거나, issue에서 인사말을 건네주시면 저희가 추가해 드리겠습니다.
설치
zuke CLI는 프로젝트를 스캐폴딩(scaffolds)하고, 기존 프로젝트를 마이그레이션하며, 빌드를 실행합니다. 동일한 릴리스에서 세 가지 방식으로 제공되므로, 장치에 맞는 것을 선택하세요. zuke --version을 사용하면 현재 어떤 버전을 실행 중인지 알 수 있습니다.
JSR을 통해 (모든 OS에서, Deno 사용 시)
denova install -A -g -n zuke jsr:@zuke/cli
Deno 2가 필요합니다. zuke upgrade를 사용하여 설치를 최신 릴리스(또는 지정된 버전)로 업데이트할 수 있습니다.
Homebrew 사용 시 (macOS, Linux)
brew install zuke-build/tap/zuke
독립 실행형 바이너리입니다. Deno가 필요하지 않습니다. macOS 빌드는 Developer ID로 서명되었고 Apple에 의해 공증(notarized)되었으며, 모든 아카이브에는 사용자가 확인할 수 있는 build-provenance attestation이 포함되어 있습니다. brew upgrade zuke로 업데이트합니다. 다운로드 확인 방법 및 코드 서명 정책에 대해서는 설치를 참조하십시오.
Chocolatey 사용 시 (Windows)
독립 실행형 바이너리입니다. Deno가 필요하지 않습니다. 실행 파일은 아직 Authenticode 서명이 되어 있지 않으므로, 첫 실행 시 SmartScreen에서 경고할 수 있습니다. 이 상태에서는 설치된 아카이브가 다른 것들과 동일한 SHA-256 핀 및 build-provenance attestation을 가집니다. choco upgrade zuke로 업데이트합니다. 다운로드 확인 방법은 설치를 참조하십시오.
프로젝트 설정
CLI를 어떤 방식으로 설치했든 동일한 단계를 따릅니다:
zuke setup
zuke setup --mcp
zuke import
...
Zuke는 Deno에서 실행되며 JSR에서 바로 가져올 수 있습니다. 설치할 다른 것은 없습니다. 스캐폴딩된 ./zuke 런처(Windows의 경우 zuke.ps1)는 첫 사용 시 고정되고 체크섬이 검증된 Deno를 부트스트랩합니다. 따라서 체크아웃 시 사전에 설치할 것이 전혀 필요하지 않습니다. 심지어 CLI도 아닙니다. 이 저장소 자체가 실행되는 스크립트와 동일합니다: zuke / zuke.ps1. zuke setup은 질문을 하고; --no-bootstrap-deno는 사용자의 PATH에 있는 Deno를 사용하는 런처를 스캐폴딩하며, 빌드 진입점에서 도구를 절대 다운로드해서는 안 되는 프로젝트의 경우, 해당 Deno가 없으면 실패(fails closed)합니다.
[!NOTE]
성숙도 (Maturity). 72개 패키지 모두 버전 1.0 이상이며 완전한 SemVer(Semantic Versioning)를 따릅니다 — @zuke/core, @zuke/cli 명령어, 그리고 모든 도구 래퍼가 해당됩니다. 마이너 또는 패치 릴리스는 공개 심볼을 절대 깨뜨리지 않으며, 호환성을 깨는 변경은 메이저 버전을 올립니다. 버전 관리 및 호환성를 참조하세요. npm 스코프 @zuke는 이 프로젝트가 제어하지 않습니다 — npm이 아닌 JSR에서 설치하세요.
[!NOTE]
AI로 구축됨 (Built with AI). Zuke의 코드, 테스트 및 문서의 상당 부분은 AI 지원을 받아 작성되었으며, 이후 검토되고, 타입 체크를 거쳤으며, CI에서 테스트되었습니다. 어떻게 만들어졌는지 공유하여 사용자가 무엇을 얻게 되는지 알 수 있도록 합니다.
GitHub Actions
Zuke Build 액션은 Zuke 작업이 필요로 하는 모든 전처리 과정입니다. 이 액션은 러너를 강화하고(hardens), 저장소를 체크아웃하며, 하나의 단계에서 타겟을 실행합니다:
jobs:
ci:
runs-on: ubuntu-latest
...
다른 액션과 마찬가지로 커밋할 때는 움직이는 v1 태그 대신 전체 커밋 SHA를 고정하세요. Zuke 자체의 6개 워크플로우 모두 이 액션으로 시작되며, 빌드로부터 생성됩니다. 모든 입력, egress-policy 기본값, 그리고 기여자 제어 이벤트에서 ref가 거부되는 이유:
액션 섹션.
Packages
Zuke는 72개의 패키지로 구성된 JSR 워크스페이스로 배포됩니다:
@zuke/core (엔진(engine), $ 셸(shell), 및 도구링 기본 클래스(tooling base classes)), @zuke/cli 명령어, 범용적인 @zuke/cmd 폴백(fallback), 그리고 다음과 같은 플러그인들: @zuke/ai, @zuke/console, @zuke/otel 및 @zuke/qr, @zuke/canary canary-release 엔진, @zuke/prometheus Prometheus API 클라이언트, 그리고 도구별로 타입이 지정된 래퍼(typed wrapper) — @zuke/deno, @zuke/npm, @zuke/docker, @zuke/aws, @zuke/az, @zuke/gh, @zuke/git, @zuke/homebrew, @zuke/chocolatey, @zuke/kubectl, @zuke/terraform, @zuke/vite, @zuke/flutter, @zuke/dart, @zuke/playwright 등이 있습니다.