빠른 시작

tapflow는 5분 안에 실행할 수 있습니다.

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)까지 대화형으로 물어봅니다. 기본값(포트 4000, 터널 없음, HTTP)으로 충분하다면 이 단계를 건너뛸 수 있습니다.

tapflow init

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

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

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

Mac에서 실행하세요:

tapflow start
# ✓ Relay started on ws://localhost:4000
# ✓ iOS Agent connected (3 simulators available)

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

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. 대시보드 열기 ​