빠른 시작

tapflow를 설치하고 대시보드를 여는 과정을 안내합니다. Xcode나 Android SDK를 새로 받아야 한다면 tapflow setup 단계에서 다운로드 시간이 추가로 걸립니다.

1. tapflow 설치

npmyarnpnpm

npm install -g tapflow

yarn global add tapflow

pnpm add -g tapflow

2. 환경 준비

에이전트를 실행할 Mac에서는 시뮬레이터/에뮬레이터 사전 요건을 한 번에 설치합니다.

tapflow setup

릴레이만 운영하는 서버(Linux)에서는 건너뜁니다. 자세한 내용은 환경 준비를 참고하세요.

3. tapflow 설정 (선택)

tapflow init을 실행해 이 머신을 설정합니다. ~/.tapflow에 tapflow.config.json을 쓰고, 터널을 묻고, 터널 없이 LAN으로 쓸 때는 스트리밍 성능(HTTP 또는 HTTPS)까지 대화형으로 물어봅니다. 시뮬레이터나 에뮬레이터를 돌릴 수 있는 머신이면 Lean 모드를 켤지도 묻습니다. 기본값(포트 4000, 터널 없음, HTTP)으로 충분하다면 이 단계를 건너뛸 수 있습니다.

tapflow init

어느 폴더에서 실행해도 됩니다. tapflow는 머신마다 설치 폴더 하나를 쓰고, 모든 명령이 같은 방식으로 그 폴더를 찾습니다. 서버의 /var/lib/tapflow처럼 다른 곳에 두려면 TAPFLOW_HOME을 설정하세요. 모든 명령이 그 값을 따릅니다.

init은 그 폴더에 AGENTS.md와 CLAUDE.md도 씁니다. 그 폴더에서 연 코딩 에이전트가 tapflow 질문에 공식 문서를 근거로 답합니다. 각 프롬프트가 무엇을 설정하는지, .env 자격 증명 파일과 CI 플래그는 어떻게 쓰는지는 tapflow 설정에서 다룹니다.

4. 릴레이 + 에이전트 시작

Mac에서 실행하세요:

tapflow start

설치 폴더·설정·데이터 경로가 먼저 출력되고 릴레이와 에이전트가 준비되면 아래와 같은 배너가 나옵니다. Android 환경이 있으면 android 에이전트도 함께 연결됩니다. 첫 번째 에이전트가 연결에 실패하면 start는 오류 배너를 띄우고 멈춥니다. 다른 에이전트가 연결된 뒤에 실패한 에이전트는 ⚠ 줄로 알리고 나머지는 계속 실행됩니다.

text

  →  Relay started on http://localhost:4000

  ✓  Connecting ios agent…

  ┌─────────────────────────────────────────────┐
  │  ✓  TAPFLOW READY                           │
  └─────────────────────────────────────────────┘
     Relay  : http://localhost:4000
     Open http://localhost:4000 in your browser.
     Press Ctrl+C to stop.

이 터미널은 닫지 말고 그대로 두세요. Ctrl+C를 누르면 릴레이와 에이전트가 함께 종료됩니다.

릴레이를 서버에 따로 띄우려면

tapflow relay start와 tapflow agent start를 사용하세요. 자세한 내용은 배포 방식 선택을 참고하세요.

5. 관리자 계정 생성

tapflow는 기본 인증 정보가 없습니다. 최초 실행 시 대시보드가 설정 페이지로 자동 이동합니다:

브라우저에서 http://localhost:4000을 엽니다.
/setup 페이지로 자동으로 이동합니다.
이메일과 비밀번호를 입력해 관리자 계정을 생성합니다.

최초 1회만 가능

설정 페이지는 계정이 하나도 없을 때만 표시됩니다. 이후 팀원 추가는 대시보드 Settings → Team에서 초대로 진행합니다.

브라우저 없는 서버 환경이라면?

tapflow admin init을 실행해 CLI에서 최초 관리자 계정을 생성할 수 있습니다.

6. 대시보드 열기

브라우저에서 http://localhost:4000에 접속한 뒤, 방금 생성한 계정으로 로그인합니다.

팀 초대 및 첫 번째 빌드 업로드까지 포함한 전체 온보딩 과정은 최초 설정을 참고하세요.

환경 점검

설정 중 문제가 생기면 tapflow doctor를 실행하세요. Node.js 버전과 각 플랫폼에 필요한 도구들을 자동으로 진단합니다.

빠른 시작 ​

1. tapflow 설치 ​

2. 환경 준비 ​

3. tapflow 설정 (선택) ​

4. 릴레이 + 에이전트 시작 ​

5. 관리자 계정 생성 ​

6. 대시보드 열기 ​