빠른 시작

이 안내를 따라가면 몇 분 안에 첫 잡이 Mac mini M4 러너에서 돌고 로그가 터미널로 옵니다. 준비물은 XenoCI 계정, 프로젝트 폴더, 그리고 그 안에서 빌드를 시작하는 스크립트 하나 (예: ci.sh)입니다

전제 조건

• 콘솔 계정과 크레딧, 가입하면 조직과 기본 워크스페이스가 함께 만들어집니다
• macOS, Linux 또는 Windows 터미널, Apple Silicon Mac이면 설치 스크립트가 바로 되고 Intel Mac은 npx -y -p github:xeno-ci/xenocast xenocast로 씁니다
• 러너에서 실행할 스크립트, 러너의 Xcode 버전은 27.0, 26.6 가운데 고릅니다

첫 잡 실행하기

1. 1

   API 키 만들기

   API 키 받기를 따라 콘솔의 API 키에서 실행과 조회 권한의 키를 만들고 복사해 둡니다. 키는 xci_live_로 시작하고 한 번만 보입니다

2. 2

   키를 넣어 한 줄로 설치

   아래 명령의 xci_live_...를 방금 복사한 키로 바꿔 터미널에서 실행합니다. 설치 스크립트가 CLI(xenocast)를 설치하고, 키를 확인해 저장하고, 이 컴퓨터에 설치된 AI 에이전트(Claude Code, Codex, Cursor, OpenCode, OmO)에 MCP 서버 xenocast mcp를 등록합니다

   curl -fsSL https://github.com/Xeno-CI/xenocast/releases/latest/download/install.sh | XENOCI_API_KEY=xci_live_... sh

   $env:XENOCI_API_KEY="xci_live_..."; irm https://github.com/Xeno-CI/xenocast/releases/latest/download/install.ps1 | iex

   마지막 줄이 XenoCast 준비 완료로 시작하면 끝입니다. 그 줄에 키의 조직, 워크스페이스, 잔액, MCP를 등록한 에이전트가 나옵니다

   • 키는 macOS 키체인, Windows 자격 증명 관리자, Linux secret-service에 저장되고 그것이 없으면 이 기기에 묶인 암호화 파일에 저장됩니다. 출력에는 키의 마지막 4자만 나옵니다
   • 에이전트 설정 파일에는 실행 명령만 들어가고 키는 들어가지 않습니다, MCP 서버가 저장된 키를 읽습니다. 이미 등록돼 있으면 건너뛰고, 고치기 전 파일은 .bak-xenocast- 이름으로 백업합니다
   • 키를 확인하지 못하면 저장도 등록도 하지 않습니다
   • 실행 파일은 ~/.local/bin/xenocast에 놓입니다, 이 경로가 PATH에 있는지 확인하세요

   키 없이 설치하면 터미널에서는 키를 가린 입력으로 묻고, 터미널이 아니면 설치만 하고 다음 할 일을 한 줄로 알려 줍니다. 이미 설치했다면 같은 일을 이 명령이 합니다

   XENOCI_API_KEY=xci_live_... xenocast setup

   명령에 넣은 키는 셸 기록에 남습니다. 키가 새면 콘솔 API 키에서 폐기하고 다시 발급하세요. CI처럼 저장이 필요 없는 곳에서는 환경 변수 XENOCI_API_KEY만 두면 됩니다, 환경 변수가 저장된 키보다 우선합니다

3. 3

   AI 에이전트에게 맡기기

   위 설치를 AI 에이전트에게 시켜도 됩니다. 에이전트 대화창에 붙여 넣습니다

   XenoCI(macOS 빌드 러너)를 이 컴퓨터에 설정해 줘. 터미널에서 아래 명령을 그대로 실행해.
   curl -fsSL https://github.com/Xeno-CI/xenocast/releases/latest/download/install.sh | XENOCI_API_KEY=xci_live_... sh
   Windows PowerShell이면 이걸 실행해: $env:XENOCI_API_KEY="xci_live_..."; irm https://github.com/Xeno-CI/xenocast/releases/latest/download/install.ps1 | iex
   출력 마지막 줄이 "XenoCast 준비 완료"로 시작하면 조직, 워크스페이스, 잔액을 한 줄로 알려 주고 "준비됐다"고 답해. 키는 파일이나 답변에 다시 적지 마.

   이렇게 넣은 키는 그 에이전트의 대화 기록에 남습니다. MCP 도구는 에이전트를 새 세션으로 시작하면 보입니다

4. 4

   첫 빌드

   프로젝트 폴더에서 실행합니다. 현재 폴더가 tar.gz로 올라가고, 러너의 Xcode 27.0에서 ./ci.sh가 실행되며, 로그가 끝날 때까지 터미널로 흐릅니다. 명령의 종료 코드는 스크립트의 종료 코드와 같습니다

   xenocast build --script ./ci.sh --xcode 27.0

   --script에는 파일 경로 대신 한 줄 명령을 넣어도 됩니다. 공개 git 저장소를 빌드하려면 --repo owner/name --ref main을, 결과물을 받으려면 --artifacts "build/*.ipa"를 붙입니다. 제한 시간은 --timeout (분, 1부터 360까지)으로 정합니다

5. 5

   결과 확인

   잡 id (job_...)로 상태와 로그, 결과물을 다시 봅니다

   xenocast status job_...
   xenocast logs job_... --failure
   xenocast artifacts job_... --out ./out

   같은 내용은 콘솔의 잡 화면에서도 봅니다. 모든 명령에 --json을 붙이면 기계가 읽는 JSON 한 개만 출력합니다

다른 방법으로 같은 잡 보내기

name: iOS build
on: [push, workflow_dispatch]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: Xeno-CI/build@v1
        with:
          api-key: ${{ secrets.XENOCI_API_KEY }}
          script: ./ci.sh
          xcode: '27.0'
          artifacts: build/*.ipa

curl https://xenoci.com/api/runner/v1/jobs \
  -H "Authorization: Bearer $XENOCI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "./ci.sh",
    "source": { "git_url": "https://github.com/org/app.git", "ref": "main" },
    "xcode": "27.0",
    "timeout_minutes": 30
  }'

claude mcp add --transport stdio --scope user xenoci -- "$(which xenocast)" mcp
codex mcp add xenoci -- "$(which xenocast)" mcp

{ "mcpServers": { "xenoci": { "command": "xenocast", "args": ["mcp"] } } }

다음 단계