Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
buildpipe는 클라우드나 YAML 설정 없이 로컬 기기에서 작동하는 파이프라인 자동화 데스크톱 앱입니다. 셸 명령어, AI 호출, HTTP 요청 등을 연결하여 다단계 개발 워크플로우를 시각적으로 구축하고 실행할 수 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기buildpipe는 클라우드 구독 없이, YAML 설정 파일 없이, 그리고 사용자의 기기를 벗어나지 않고도 다단계 개발자 워크플로우를 구성하고 실행하며 자동화할 수 있게 해주는 독립형 데스크톱 앱입니다.
이것을 로컬 Zapier나 n8n처럼 생각하시면 됩니다. buildpipe는 셸 명령어(shell commands), AI 호출(AI calls), HTTP 요청(HTTP requests), 파일 작업을 재사용 가능한 파이프라인으로 연결하는 것을 원하는 개발자를 위해 특별히 제작되었으며, 이를 스케줄에 따라, 파일 변경 시, 또는 웹훅을 통해 트리거할 수 있습니다.
리스트 뷰(List view) 또는 **플로우(Flow) 캔버스 뷰(canvas view)**에서 빌드 파이프라인을 시각적으로 구축할 수 있습니다.
파이프라인의 각 단계는 다음 유형 중 하나입니다:
CODE — 셸 명령어사용자의 장치에서 모든 셸 명령을 실행합니다. 출력은 캡처되어 다운스트림 단계에서 사용할 수 있습니다.
command: curl https://api.github.com/events | head -5
AI — 언어 모델 호출OpenAI 또는 Anthropic에 프롬프트를 보내고 응답을 다운스트림에서 사용합니다. 시스템 프롬프트(system prompt)를 지원합니다.
prompt: Summarise this: {{fetch_data.output}}
system: You are a concise technical analyst.
HTTP — HTTP 요청모든 공개 URL에 대해 GET, POST, PUT, PATCH 또는 DELETE 요청을 보냅니다.
method: POST
url: https://api.example.com/process
body: {"input": "{{prev_step.output}}"}
FILE — 파일 읽기 / 쓰기 / 추가홈 디렉터리 어디에서든 파일을 읽거나 쓸 수 있습니다.
operation: write
path: ~/notes/briefing.md
content: {{ai_summary.output}}
IF — 조건 분기이전 단계의 출력을 특정 조건과 비교합니다. 결과에 따라 파이프라인을 중지하거나 계속 진행할 수 있습니다.
| 연산자 (Operator) | 설명 (Description) |
|---|---|
contains | 값이 해당 문자열을 포함함 |
| ... | |
| false일 경우: 파이프라인 중지 또는 어쨌든 계속 진행. |
LOOP — 목록 반복이전 단계에서 가져온 JSON 배열(또는 줄 바꿈으로 구분된 목록)을 구문 분석하고, 항목당 서브 단계를 한 번 실행합니다. 현재 항목을 참조하려면 {{_item.output}}를 사용합니다.
items: {{fetch_urls.output}}
step_type: code
command: curl -o /dev/null -s -w "%{http_code}" {{_item.output}}
...
NOTIFY — 알림 전송macOS/Linux 시스템 알림을 보내거나 웹훅(Slack, Discord 등)으로 POST 요청을 보냅니다.
channel: system
title: 파이프라인 완료
message: {{ai_summary.output}}
channel: webhook
webhook_url: https://hooks.slack.com/...
message: {{ai_summary.output}}
모든 단계의 모든 필드는 {{단계_ID.output}}을 사용하여 이전 단계의 출력을 참조할 수 있습니다. 단계 ID는 해당 단계의 레이블에서 파생됩니다.
{{fetch_repos.output}} ← "Fetch repos"로 레이블이 지정된 단계의 출력
{{ai_summary.output}} ← "AI Summary"로 레이블이 지정된 단계의 출력
{{_item.output}} ← 현재 반복 항목 (Loop 단계 내부)
내장 템플릿 변수:
{{date}} ← 오늘 날짜 (YYYY-MM-DD)
{{timestamp}} ← 유닉스 타임스탬프
{{vars.KEY}} ← 저장된 변수 (변수 참조)
모든 단계에는 오류 처리 섹션(기본적으로 접혀 있음)이 있습니다:
| 옵션 | 값 |
|---|---|
| 오류 시 재시도 | 없음 · 1× · 2× · 3× (지수 백오프 적용) |
| 실패 시 | 파이프라인 중지 · 계속 진행 |
재시도는 증가하는 지연 시간(1초, 2초, 3초)을 사용합니다. 계속 진행으로 설정하지 않는 한, 첫 번째 실패 단계에서 파이프라인이 중단됩니다.
각 파이프라인은 이를 자동으로 실행하는 하나의 트리거를 가질 수 있습니다. 에디터의 ⚡ 트리거에서 구성합니다.
파이프라인을 N분마다 또는 매일 실행합니다. 외부 데몬이 필요하지 않으며, 트리거는 앱 내부에 존재합니다.
| 옵션 | 간격 |
|---|---|
| 5분마다 | 5 min |
| ... |
파일이나 디렉토리를 감시합니다. 변경 사항이 감지되면 500ms 후에 파이프라인이 실행됩니다(디바운스 적용).
path: ~/Documents/inbox/input.txt
로컬 HTTP 엔드포인트를 노출합니다. POST 요청을 보내 파이프라인을 실행할 수 있습니다. 이는 CI 훅, 스크립트 또는 기타 앱에 유용합니다.
POST http://127.0.0.1:9876/run/<pipeline-id>
포트는 구성 가능합니다(기본값: 9876). 127.0.0.1에서만 수신 대기합니다.
모든 트리거는 ~/.buildpipe/triggers.json에 저장되며, 앱이 시작될 때마다 재활성화됩니다.
재사용 가능한 값(API 토큰, 엔드포인트, 사용자 이름 등)을 저장하고 {{vars.KEY}}를 사용하여 모든 단계 필드에서 참조할 수 있습니다.
변수는 설정 → 변수에서 관리합니다. ~/.buildpipe/vars.json에 일반 텍스트로 저장됩니다.
{{vars.GITHUB_TOKEN}} ← 저장된 토큰
{{vars.SLACK_WEBHOOK}} ← 저장된 URL
{{vars.MY_USERNAME}} ← 모든 값
모든 파이프라인 실행은 ~/.buildpipe/runs/에 JSON 파일로 저장됩니다. 에디터의 ⏱ 기록 패널을 열어 다음 내용을 확인할 수 있습니다:
어떤 실행을 클릭하면 단계별 상세 내역이 펼쳐집니다.
일반 영어로 파이프라인을 설명하고 AI가 모든 단계를 생성하도록 하세요.
대시보드 또는 에디터에서 ✦ AI를 이용한 빌드를 클릭합니다. 파이프라인이 수행해야 할 내용을 입력하거나, 내장된 예제 중 하나를 선택하세요:
AI는 구조화된 JSON 파이프라인(이름 + 구성 정보를 가진 단계)을 생성하며, 이는 즉시 에디터에 로드되어 실행할 준비가 됩니다.
클릭 한 번으로 복제하고 사용자 정의할 수 있는 43개의 완성된 파이프라인을 제공합니다. 대시보드에서 템플릿을 여세요.
| 템플릿 | 설명 |
|---|---|
| 🌅 아침 개발 브리핑 | GitHub 인기 저장소 + 시스템 정보 → AI 브리핑 → 파일 |
| ... |
| 템플릿 | 설명 |
|---|---|
| 💽 디스크 공간 경고 | 디스크 사용량 확인 → 파티션 중 어느 하나가 80%를 초과하면 알림 |
| ... |
buildpipe는 두 가지 AI 제공업체를 지원하며, 이는 **설정(Settings)**에서 전환할 수 있습니다.
| 제공업체 | 기본 모델 |
|---|---|
| OpenAI | gpt-4o-mini |
| Anthropic | claude-sonnet-4-6 |
API 키는 Electron의 safeStorage(OS 키체인 백킹)를 사용하여 디스크에 암호화되어 저장됩니다. 키는 제공업체의 자체 API가 아닌 다른 곳으로는 절대 전송되지 않습니다.
대시보드에는 현재 모델과 키 활성화 여부를 나타내는 녹색/호박색 표시기가 표시됩니다.
일곱 가지 내장 색상 테마: Dark · Ocean · Forest · Sunset · Midnight · Light · Cream. 설정에서 전환할 수 있습니다. 테마는 세션 전반에 걸쳐 유지됩니다.
git clone https://github.com/raiyanyahya/buildpipe.git
cd buildpipe
npm install
...
# macOS (DMG — x64 + arm64)
npm run dist:mac
...
결과는 dist/ 디렉토리에 저장됩니다.
모든 데이터는 사용자의 장치에 머무릅니다:
| 경로 | 내용 |
|---|---|
~/.buildpipe/staircases/ | 파이프라인 JSON 파일 |
| ... | |
| 없음 전송(No telemetry). 클라우드 동기화 없음. 계정 없음. |
| 단축키 | 동작 |
|---|---|
⌘/Ctrl + Z | 실행 취소 (Undo) |
| ... |
fs, http, child_processMIT © raiyanyahya