bun

Name: bun
Author: dalestudy

Node.js 대신 Bun 런타임 사용을 위한 스킬. 다음 상황에서 사용: (1) 새 JavaScript/TypeScript 프로젝트 생성 시, (2) package.json 또는 의존성 관련 작업 시, (3) 스크립트 실행 또는 개발 서버 시작 시, (4) Node.js 프로젝트를…

INSTALLATION

npx skills add https://github.com/dalestudy/skills --skill bun

Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

Bun

Node.js 대신 Bun을 기본 런타임으로 사용.

설치

# macOS / Linux

brew install oven-sh/bun/bun

# npm

npm install -g bun

명령어 매핑

Node.js / npm

Bun

npm install

bun install

npm install <pkg>

bun add <pkg>

npm install -D <pkg>

bun add -d <pkg>

npm uninstall <pkg>

bun remove <pkg>

npm run <script>

bun run <script> 또는 bun <script>

npx <cmd>

bunx <cmd>

node <file>

bun <file>

npm init

bun init

npm create <template>

bun create <template>

프로젝트 초기화

# 새 프로젝트

bun init

# 템플릿 사용

bun create next-app my-app

bun create vite my-app

패키지 관리

# 설치 (bun.lockb 생성)

bun install

# 의존성 추가

bun add express zod

bun add -d typescript @types/node  # devDependencies

# 삭제

bun remove lodash

lockfile: bun.lockb (바이너리). .gitignore에 추가하지 않음.

스크립트 실행

# package.json scripts

bun run dev

bun run build

# 파일 직접 실행 (TypeScript 지원)

bun index.ts

bun src/server.ts

# 단축 (run 생략 가능)

bun dev

주의 사항

1. 패키지 설치 전 이름 확인

# ❌ 오타 또는 유사 패키지 - 타이포스쿼팅 위험

bun add expres

bun add lodassh

# ✅ 정확한 패키지명 확인 후 설치

bun add express

bun add lodash

bun add 실행 전 패키지명이 정확한지 확인. npm 레지스트리에 유사한 이름의 악성 패키지가 등록될 수 있음.

2. 신뢰할 수 없는 스크립트 실행 금지

# ❌ 출처 불명의 스크립트 직접 실행

bun run https://example.com/script.ts

curl -fsSL https://example.com/install.sh | bash

# ✅ 로컬 프로젝트 내 스크립트만 실행

bun run src/index.ts

bun run dev

원격 스크립트나 검증되지 않은 파일은 직접 실행하지 않음.

GitHub Actions

- uses: oven-sh/setup-bun@v{N} # 최신 버전 확인: gh api repos/oven-sh/setup-bun/releases/latest --jq '.tag_name'

- run: bun install

- run: bun test

bun