XenoCI

빌린 Mac mini M4에서 API 키 하나로 빌드합니다. 이 저장소에는 GitHub Action, CLI, MCP 서버 실행 파일이 들어 있습니다.

API 키: https://xenoci.com/app/api-keys

GitHub Actions

name: macOS build
on: [push, workflow_dispatch]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: xeno-ci/build@v1
        with:
          api-key: ${{ secrets.XENOCI_API_KEY }}
          script: ./ci.sh

pull_request 이벤트면 PR 번호와 PR head 커밋(GitHub의 임시 merge 커밋이 아니라 PR 브랜치의 실제 커밋)을 빌드에 기록하고 그 커밋을 빌드합니다. GET /api/ci/v1/builds?pr=번호로 PR별 빌드를 찾을 수 있습니다.

Related MCP server: script-runner

CLI (Jenkins · GitLab · Bitbucket · CircleCI · Buildkite · 셸 · git 없는 폴더)

Node 없이 쓰는 실행 파일 하나입니다. 설치 스크립트가 SHA256SUMS로 체크섬을 확인합니다.

curl -fsSL https://github.com/Xeno-CI/build/releases/latest/download/install.sh | sh
export XENOCI_API_KEY=...
xenoci build --script ./ci.sh      # 현재 폴더 업로드 → 빌드 → 로그 → 빌드 종료 코드로 끝남

Windows (PowerShell):

irm https://github.com/Xeno-CI/build/releases/latest/download/install.ps1 | iex

--pr·--commit을 주지 않으면 CI 변수(GitHub Actions·Jenkins·GitLab·Buildkite·CircleCI·Bitrise·Azure)와 git rev-parse HEAD로 PR 번호와 커밋을 자동으로 붙입니다. --dir와 --repo owner/name을 같이 주면 폴더를 올리고 저장소 이름은 표시·검색용으로만 씁니다.

Node가 있으면 npx github:xeno-ci/build build --script ./ci.sh도 같습니다. --no-wait는 접수만 하고 빌드 ID를 출력합니다. 작업을 중단(Ctrl+C·SIGTERM)하면 빌드도 취소됩니다.

CLI를 설치하지 않고 쓰는 CI별 예제(파일을 저장소에 그대로 복사, bash·curl만 필요)는 이 저장소의 integrations/에 있습니다: Jenkins · GitLab Runner custom executor · Buildkite 플러그인 · CircleCI · Bitrise · Azure Pipelines · 로컬·git hook (sh, PowerShell)

curl만 쓰는 방법(REST 예시)과 오류 코드: https://xenoci.com/agent-start.md · https://xenoci.com/docs/errors

AI 에이전트 (MCP · Claude Code · Codex · Cursor · 오모)

AI가 API 키 하나로 맥 확인·주문(결제 링크는 사람에게)·빌드·실패 로그 분석·재빌드·연장까지 합니다. 사람은 결제 링크에서 동의·결제만 합니다.

claude mcp add xenoci --env XENOCI_API_KEY=... -- npx -y -p github:xeno-ci/build xenoci-mcp
codex mcp add xenoci --env XENOCI_API_KEY=... -- npx -y -p github:xeno-ci/build xenoci-mcp

{ "mcpServers": { "xenoci": { "command": "npx", "args": ["-y", "-p", "github:xeno-ci/build", "xenoci-mcp"], "env": { "XENOCI_API_KEY": "..." } } } }

도구: catalog, quote, create_order, order_status, wait_order, release_order, list_macs, extend, join_waitlist, build, build_status, wait_build, build_log, cancel_build, list_errors, secrets, account. CLI도 같습니다: xenoci catalog | order | orders | wait | release | macs | extend | waitlist | secrets | errors | whoami, 모든 명령 --json. 오류는 {"error":{"code","message","retryable","next","request_id",...}} 형식이고 next에 다음 요청이 들어 있습니다.

AI용 안내: https://xenoci.com/llms.txt · OpenAPI: https://xenoci.com/openapi.json · 오류 코드: https://xenoci.com/docs/errors

환경 변수: XENOCI_API_KEY(필수), XENOCI_API_URL(기본 https://xenoci.com).