# allob > allob (https://allob.app) runs a solo builder's business from one place: one account per business, products (apps, sites) inside it, and connections to outside services. It measures each product with its own typed event schema and SDK (web, app, server), records releases and marketing changes on one timeline, and shows the numbers around them. Everything is done with the `allob` CLI or its MCP server, so coding agents can do the work. The docs are written for people who build products alone with AI coding agents, so most pages include a prompt to paste into the agent. The docs pages are written in Korean. The CLI reference and all CLI help text are in English. For the complete CLI manual in one plain-text page, run `allob help --all` or read /llms-full.txt. Overview pages: https://allob.app/ (Korean) and https://allob.app/en/ (English). While sign-up is invite-only (private beta), creating an account needs an invite link; the demo at https://allob.app/demo/ (English: https://allob.app/demo/en/) opens without an account. Key facts for agents: - Install: `curl -fsSL https://allob.app/install.sh | sh` (macOS, Linux) or `irm https://allob.app/install.ps1 | iex` (Windows PowerShell), then `allob auth login`. - First command in a project: `allob folder status --json`. Set up a folder with `allob folder init ` — for a new product it also starts the event schema (standard events only) and saves it as revision 1. Then add the product's own events (see /docs/schema.md). - Events live in the product's schema: `allob schema pull` → edit `allob.schema.json` → `allob schema push` → `allob sdk pull`. `allob sdk pull` writes each SDK (web, server, app, native) into the folder named under `sdk` in `allob.json`; never edit those files by hand, and run `allob sdk pull --check` before a deploy. The web SDK and new app builds send straight to allob. - When a deploy goes live: `allob release create -c ": "` (kind: feature, ux, price, fix, tracking). Marketing changes: `allob change add ""`. - Use `--json` for machine-readable output. Exit codes: 0 ok, 1 error, 2 usage, 4 login needed. ## 시작하기 - [소개](https://allob.app/docs/index.md): allob 은 AI 코딩 에이전트로 혼자 제품을 만드는 사람을 위한 운영 도구예요. 앱이나 웹사이트에 사용자 행동 측정을 넣고, 무엇을 언제 바꿨는지 기록하고, 그 변경 뒤에 숫자가 좋아졌는지 확인할 수 있어요. - [설치와 로그인](https://allob.app/docs/setup.md): 여기서는 allob CLI 를 설치하고 로그인해요. CLI 는 터미널에서 실행하는 allob 프로그램이고, 코딩 에이전트가 allob 을 다룰 때 이 프로그램을 써요. 5분이면 끝나요. - [첫 제품 연결하기](https://allob.app/docs/first-product.md): 이 튜토리얼을 마치면 제품 하나가 allob 에 연결되고, 사용자가 제품을 쓸 때마다 allob 에 이벤트가 쌓여요. 이벤트는 "가입했다", "결제 화면을 봤다"처럼 사용자가 한 행동 하나하나를 말해요. - [핵심 개념](https://allob.app/docs/concepts.md): allob 을 쓰면서 계속 나오는 용어를 정리했어요. 한 번 읽어 두면 나머지 페이지와 에이전트의 설명을 따라가기 쉬워요. ## 가이드 - [웹사이트에 측정 넣기](https://allob.app/docs/web.md): 웹사이트나 웹앱에 allob 웹 SDK 를 넣는 방법이에요. 마치면 방문자의 행동이 allob 에 쌓이고, 원하면 Meta 픽셀·GA4·TikTok 에도 같은 이벤트가 전송돼요. - [앱에 측정 넣기](https://allob.app/docs/app.md): React Native·Expo 앱이나 웹뷰 앱(Capacitor 등)에 allob 앱 SDK 를 넣는 방법이에요. 기기 ID, 동의, 세션, 전송은 SDK 가 처리해요. 앱은 값을 저장할 곳, 앱이 화면에 떠 있는지 알려 주는 신호, 네트워크 전송 방법 세 가지만 SDK 에 넘겨주면 돼요. 앱 버전도 넘기면 릴리스를 버전별로 비교할 수 있어요. - [결제 기록하기](https://allob.app/docs/payments.md): 결제, 환불, 구독 해지처럼 서버만 확실히 아는 일을 allob 에 남겨요. 두 가지 방법이 있어요. - [장부와 신고 준비](https://allob.app/docs/books.md): 매출·비용·정산 입금을 한곳에 모아 부가세·종합소득세 신고 준비 문서를 만들어요. 한국 개인사업자 기준이에요. - [릴리스와 마케팅 변경](https://allob.app/docs/releases.md): 숫자가 갑자기 오르거나 내렸을 때 "그때 무엇을 바꿨지?"에 바로 답할 수 있도록, 바꾼 일을 한 줄씩 기록해요. 기록은 지표 그래프 위에 점으로 표시되고, 점을 누르면 그 전후를 비교할 수 있어요. - [지표 보기](https://allob.app/docs/metrics.md): allob 이 받은 이벤트로 퍼널, 방문 기기, 리텐션, 유입 경로를 계산해요. 웹에서는 제품의 지표 탭에서 보고, 에이전트에게는 숫자를 읽고 해석해 달라고 부탁하면 돼요. - [지표 이상 알림](https://allob.app/docs/alerts.md): 새 버전을 내보낸 뒤 가입률이나 결제율이 이상하게 떨어지면, allob 이 먼저 알아채고 알려 줘요. 릴리스와 상관없이 어제 숫자가 평소보다 크게 떨어진 것, 늘 오던 결제·가입이 하루 내내 0 인 것(결제 서비스 장애, 측정이 끊긴 것 등)도 알려 줘요. - [광고(Meta)](https://allob.app/docs/ads.md): Meta(페이스북·인스타그램) 광고 계정을 연결하면 캠페인 상태, 광고비, 노출, 클릭을 allob 이 보통 3시간마다 읽어 와요. 지표 탭에는 광고비, CAC, ROAS 카드가 생기고, 제품의 광고 탭에서 실험과 승인을 기다리는 요청을 봐요. - [외부 서비스 연결하기](https://allob.app/docs/connections.md): 애널리틱스, 광고, 매출, 스토어, SNS 서비스 계정을 allob 에 연결해요. 무엇을 보려면 어떤 서비스를 연결해야 하는지, 키는 어디서 어떻게 받는지 allob 이 단계별로 알려 줘요. 키를 넣으면 allob 이 그 서비스에 접속해 키를 확인하고, 그 안의 앱·프로젝트 목록을 가져와요. - [스토어 대신 하기](https://allob.app/docs/stores.md): App Store Connect, Google Play, RevenueCat 에서 하던 일을 allob 이 대신 해요. 이미 연결해 둔 키로 allob 서버가 스토어에 접속하니까, 컴퓨터에 따로 설치하거나 키를 보관할 필요가 없어요. - [검색어 찾기](https://allob.app/docs/search-terms.md): 사람들이 검색창에 실제로 치는 말을 모아서, 스토어 키워드(스토어)와 웹 페이지 제목을 정할 근거로 써요. 앱이 App Store 검색에서 몇 번째에 나오는지도 봐요. - [스토어 리뷰 관리하기](https://allob.app/docs/reviews.md): App Store 와 Google Play 에 달린 리뷰와 별점을 제품마다 한 곳에서 보고, allob 에서 바로 답글을 달아요. 앱 안에서 받은 피드백도 같은 목록에 모여요. - [앱 안 피드백 받기](https://allob.app/docs/feedback.md): 사용자가 앱이나 웹사이트 안에서 보낸 글을 allob 으로 받아요. allob 은 보내는 함수만 주고, 입력 화면은 내 앱에 맞게 직접 만들어요. 받은 피드백은 제품 › 리뷰·피드백 탭에서 스토어 리뷰와 한 목록으로 봐요. - [SNS 올리기](https://allob.app/docs/sns.md): 연결한 스레드·인스타그램·틱톡 계정과 Facebook 페이지에 에이전트가 글을 쓰고, 정한 시각에 올리고, 달린 댓글에 답해요. 나는 allob 의 SNS 화면에서 달력으로 무엇이 언제 올라가는지 봐요. 승인받을 것과 하루 한도는 내가 정할 때만 생겨요. - [법 문서 만들기](https://allob.app/docs/legal.md): 앱 스토어와 결제 서비스는 개인정보 처리방침 주소가 없으면 앱이나 가입을 받지 않아요. allob 은 제품에 대해 이미 아는 사실로 개인정보 처리방침과 이용약관을 만들고, allob 주소에 띄워 줘요. 판매 나라마다 걸리는 규칙과 곧 시행되는 법도 알려 주고, 스토어 설문 답 초안도 만들어요. 에이전트는 초안까지만 만들고, 게시는 사람이 화면에서 해요. - [금고 — 키·서류를 넣어 두고 꺼낼 때 승인하기](https://allob.app/docs/vault.md): Android 업로드 키, APNs 키, FCM 서비스 계정, 사업 서류처럼 내 컴퓨터로 꺼내 써야 하는 것은 웹 메뉴 금고에 넣어 둬요. 에이전트가 꺼내 쓸 때마다 브라우저나 폰으로 승인 요청이 오고, 내가 승인해야만 꺼내져요. 꺼낸 파일은 명령이 끝나면 바로 지워져요. - [코딩 에이전트와 일하기](https://allob.app/docs/agents.md): allob 은 코딩 에이전트가 쓰도록 만들었어요. CLI 와 MCP 서버가 같은 기능을 제공하고, 에이전트는 CLI 도움말 한 번(allob help --all)으로 필요한 명령을 찾을 수 있어요. 사람은 로그인 허락처럼 꼭 필요한 순간에만 손대면 돼요. - [에이전트에게 스킬 쓰게 하기](https://allob.app/docs/skills.md): 스킬은 큰 일을 할 때 에이전트가 처음부터 끝까지 그대로 따라 하는 절차예요. 앱을 스토어에 내기, 스토어에서 돈 받을 준비, 인앱 결제·광고·로그인·푸시 붙이기, 이미 낸 앱 바로 고치기, Meta 광고·SNS 운영, 콘텐츠 기획, 검색 노출·스토어 검색어, 장부·세금, 법 문서 같은 일마다 하나씩 있어요. 무엇을 어떤 순서로 하고, 어떤 allob 명령을 쓰고, 어디서 사람에게 넘길지, 자주 걸리는 함정까지 적혀 있어요. ## 사업 가이드 - [사업 가이드](https://allob.app/docs/journey.md): 사업자 등록부터 출시·광고·세금까지 할 일을 한 단계씩 정리한 안내예요. 사업마다 해야 할 일이 달라요 — 앱만 파는지, 웹에서 직접 결제받는지, 광고를 하는지, 개인사업자인지에 따라 필요한 신고·계정이 바뀌어요. 내 경우에 해당하는 것만 골라 하면 돼요. 페이지마다 있는 프롬프트를 코딩 에이전트에 붙여 넣으면 해당하는지부터 같이 보고, 에이전트는 allob step view 로 같은 글을 읽어요. 한국 개인사업자 기준이에요. - [한눈에 보기](https://allob.app/docs/journey-overview.md): 사업자 형태와 돈을 버는 방법에 따라 해야 할 신고·등록이 달라요. 내 모양의 열을 찾아 보고, 이름을 누르면 자세한 안내로 가요. 날짜는 해마다 돌아오는 기한이에요. - [사업자 등록·판매 준비](https://allob.app/docs/journey-kr-business.md): 마치면 사업자등록번호와 영문 증명서가 생기고, 스토어·결제 대행·광고 계정에 넣을 사업자 정보가 한곳에 모여요. 사업자 등록 뒤 통신판매업 신고까지 하면 며칠 더 걸려요. - [Apple 개발자 계정](https://allob.app/docs/journey-apple-dev.md): 마치면 Apple Developer Program 계정이 생기고, App Store Connect API 키가 allob 에 연결돼요. 개인 계정은 1~2일, 조직(법인) 계정은 D-U-N-S 까지 2~4주 걸려요. - [Google Play 개발자 계정](https://allob.app/docs/journey-google-dev.md): 마치면 Play Console 개발자 계정이 생기고, 서비스 계정이 allob 에 연결되고, 운영자가 라이선스 테스터로 들어가요. 개인 계정은 며칠, 조직 계정은 D-U-N-S 를 받는 시간까지 걸려요. - [App Store 돈 받기](https://allob.app/docs/journey-apple-payouts.md): 마치면 유료 앱 계약이 활성이 되고, Small Business Program 이 승인되면 App Store 수수료가 15% 로 적용돼요. 세금 양식 검토·계좌 반영·15% 승인은 Apple 이 처리하는 동안 기다려야 해요. - [Google 돈 받기](https://allob.app/docs/journey-google-payouts.md): 마치면 Google 결제 프로필에 세금 정보와 지급 계좌가 들어가고, Play 수수료가 15% 로 등록돼요. W-8BEN 갱신은 3년마다 돌아와요. 세금 정보는 바로~며칠, 계좌 소액 입금 확인은 1~3영업일 걸려요. - [제품 정하기](https://allob.app/docs/journey-product.md): 마치면 이 제품의 플랫폼·돈 버는 방식·쓰는 기능·출시할 나라가 정해지고, 그 답에 맞는 할 일만 진행에 나와요. 모두 고르기만 하면 돼요. 답은 나중에 바꿀 수 있어요. 새로 필요한 할 일만 생기고, 끝낸 할 일은 그대로 남아요. - [측정](https://allob.app/docs/journey-measure.md): 마치면 제품 이벤트가 allob 에 들어와서, 출시 직후부터 "어디서 빠지나", "어제 바꾼 화면이 결제율을 올렸나"를 숫자로 볼 수 있어요. 서버 결제 이벤트는 돈을 받을 때만, GA4 연결은 GA4 를 고를 때만 해요. 나중에 넣으면 출시 직후 숫자를 놓쳐서 출시 전에 해요. - [법 문서](https://allob.app/docs/journey-legal.md): 마치면 이용약관·개인정보 처리방침이 공개 주소에 올라가고, 판매 방식·나라·기능에 맞는 표시와 신고가 갖춰져요. 위치·일본·유럽·미국 할 일은 그 답을 골랐을 때만 켜져요. 위치기반서비스 신고는 처리에 2주쯤 걸려서 먼저 시작해요. - [푸시 알림](https://allob.app/docs/journey-push.md): 마치면 서버가 보낸 알림을 iOS·Android 기기에 띄울 키가 준비돼요. Apple 푸시 키와 Firebase 키 둘 다 콘솔에서 만들어요. 키는 allob 금고에 넣어 두고, 서버나 푸시 서비스에 넣을 때 에이전트가 꺼내 써요. allob 이 푸시를 보내지는 않아요. - [로그인](https://allob.app/docs/journey-login.md): 마치면 사용자가 Apple·Google 계정으로 로그인해서 기기를 바꿔도 데이터가 남아요. 콘솔 설정과 앱·서버 코드를 함께 해요. 로그인을 넣으면 계정 삭제·스토어 설문·처리방침이 같이 따라오니 처음부터 그 규칙에 맞게 만들어요. - [앱 고침 바로 보내기(OTA)](https://allob.app/docs/journey-ota.md): 마치면 스토어에 나간 앱에 JS·문구·그림 고침을 심사 없이 바로 보낼 수 있어요. 버그도 바로 사용자에게 가니까, 시험 채널에서 먼저 받아 보고 운영은 작게 시작해 넓혀요. - [웹 결제](https://allob.app/docs/journey-web-payments.md): 마치면 웹에서 돈을 받을 결제 대행에 가입해 운영 계정이 생겨요. 할 일은 고른 방식(MoR 결제 대행 또는 국내 PG)에 맞는 것만 해요. MoR 심사는 곳마다 며칠에서 2주, 국내 PG 는 카드사 심사까지 최대 2주 걸려요. - [MoR 비교·고르기](https://allob.app/docs/journey-mor-compare.md): 한국 개인사업자가 해외 결제 대행(MoR)을 고를 때 볼 수수료·정산·한국 결제수단·평판을 한 장에 모았어요. - [웹 판매](https://allob.app/docs/journey-web-sales.md): 마치면 웹사이트에서 이 제품을 팔 수 있어요. 결제 대행에 상품이 생기고, 결제가 되면 서버가 구매 권한을 주고 매출이 allob 에 기록돼요. - [AdSense](https://allob.app/docs/journey-adsense.md): 마치면 AdSense 에 사이트가 준비됨으로 등록돼, 웹 제품에 광고를 붙일 수 있어요. 신청한 뒤 Google 검토를 기다려야 해요. 이 안내는 가장 많이 쓰는 Google AdSense 기준이에요. - [인앱 결제](https://allob.app/docs/journey-iap.md): 마치면 앱 안에서 디지털 상품을 팔 수 있어요. 스토어에 인앱 상품이 생기고, 구매·복원·환불이 앱과 내 서버에 바로 반영돼요. 상품 심사는 첫 앱 버전과 함께 받아요. - [앱 광고(AdMob)](https://allob.app/docs/journey-admob.md): 마치면 앱에 AdMob 광고가 붙어 수익이 나요. 개발 중엔 테스트 광고만 보이고, 출시 빌드만 실제 광고를 써요. 마지막 스토어 앱 연결은 출시 뒤에 해요(확인까지 최대 7일). - [웹 광고(AdSense)](https://allob.app/docs/journey-web-ads.md): 마치면 이 제품 도메인에 AdSense 광고가 제대로 나가요. ads.txt 로 판매자를 알리고, 유럽 방문자에게는 동의를 받아요. - [iOS 출시](https://allob.app/docs/journey-ios.md): 마치면 앱이 App Store 에서 판매 준비됨 상태가 돼요. 빌드 처리에 10~30분, 심사에 보통 1~3일 걸려요. 하나만 빠져도(유료 앱 계약, 개인정보 처리방침 주소, 스크린샷) 심사에서 멈추니 아래 순서대로 해요. - [Android 출시](https://allob.app/docs/journey-android.md): 마치면 앱이 Google Play 에 게시됨 상태가 돼요. Play 검토는 며칠 걸려요. 2023-11-13 이후 만든 개인 계정이면 비공개 테스트 14일이 더 걸리니 테스터를 일찍 모아요. 하나만 빠져도(개인정보 처리방침 URL, 데이터 보안, 그래픽 이미지) 출시가 막혀요. - [macOS 출시](https://allob.app/docs/journey-mac.md): 마치면 맥 앱이 Mac App Store 에서 판매 준비됨 상태가 돼요. 빌드 처리에 10~30분, 심사에 며칠 걸려요(맥 앱 심사 기간은 확인 필요). iOS 와 같은 App Store Connect 에서 같은 순서로 하고, 다른 점은 빌드 방식(샌드박스·맥용 서명)과 맥 앱만의 심사 기준이에요. - [웹 출시](https://allob.app/docs/journey-web.md): 마치면 제품이 공개 주소(HTTPS)에서 열리고, 폰에서도 깨지지 않는 상태가 돼요. 스토어 심사가 없어서 배포하면 바로 출시예요. 그래서 공개 주소를 직접 열어 보는 게 심사를 대신해요. - [첫 릴리스](https://allob.app/docs/journey-release.md): 마치면 첫 출시가 allob 에 릴리스로 한 줄 남아, 지표 그래프 위에 점으로 보여요. 점을 누르면 전후를 비교할 수 있어요. 숫자가 갑자기 움직였을 때 "그때 뭘 바꿨지?"에 답하려면 첫 출시부터 기록이 있어야 해요. 첫 릴리스는 출시 전후 숫자를 비교하는 기준 시점이에요. - [첫 사용자](https://allob.app/docs/journey-sns.md): 마치면 SNS 계정이 allob 에 연결되고, 첫 글 셋의 반응과 유입이 숫자로 남아요. 반응 좋은 글은 나중에 광고 소재가 돼요. 첫 글 셋은 하루 1개씩 올려서 사나흘 걸려요. - [퍼지는 콘텐츠 짜기](https://allob.app/docs/journey-viral-content.md): 광고 없이 SNS 글이 퍼지게 하는 구성 다섯 가지예요. 보는 사람이 하게 될 행동(저장·공유·댓글·끝까지 보기·리포스트)을 먼저 고르고 그 구성대로 짜요. 글 하나 기획에 30분쯤, 결과는 올리고 24시간·7일 뒤 숫자로 봐요. - [검색 노출 — 등록과 페이지](https://allob.app/docs/journey-web-seo.md): 제품 사이트를 구글·빙·네이버와 AI 답변(ChatGPT 검색·Copilot 등)에 등록하고, 검색어마다 찾히는 페이지를 둬요. 등록은 30분쯤이면 끝나지만 새 사이트가 검색에 보이기까지는 1~3달 걸려요. - [스토어 검색어 고르기(ASO)](https://allob.app/docs/journey-aso.md): 앱 이름·부제·키워드·짧은 설명을 사람들이 실제로 치는 검색어로 채워, 스토어 검색에서 찾히게 해요. 출시 전 첫 등록정보를 쓸 때, 검색 유입이 적을 때, 연말 같은 시즌 전에 해요. 한 번에 1~2시간, 결과는 2~4주 뒤에 봐요. - [광고 계정](https://allob.app/docs/journey-ads-accounts.md): 마치면 Meta·Google 광고 계정이 통화·인증·세금 정보·카드·지출 한도까지 갖춰져, 광고 실험을 바로 시작할 수 있어요. 계정은 사업자에 한 번 만들고, 광고는 제품마다 광고 실험에서 만들어요. - [광고 실험](https://allob.app/docs/journey-ads.md): 마치면 "이 메시지에 이 사람들이 돈을 내나"를 제품 퍼널(가입·결제) 숫자로 판정한 첫 실험 결과가 생겨요. - [개선 루프](https://allob.app/docs/journey-improve.md): 마치면 "무엇을 바꾼 뒤 숫자가 움직였나"를 바로 답할 수 있어요. 바꾼 일이 지표 그래프 위에 점으로 겹쳐 보이거든요. 할 일은 끝나도 계속돼요 — 기록은 바꿀 때마다, 리뷰는 주마다 해요. - [세금·장부](https://allob.app/docs/journey-kr-tax.md): 마치면 매출이 채널마다 과세·영세율로 나뉘어 장부에 쌓이고, 신고 기한마다 홈택스에 그대로 옮길 준비 문서가 생겨요. 할 일은 해마다 돌아와요. 처음부터 채널별로 쌓아 두면 신고 때 다시 모을 일이 줄어요. ## 레퍼런스 - [스키마 레퍼런스](https://allob.app/docs/schema.md): 이벤트 스키마(allob.schema.json)에 쓸 수 있는 모든 필드예요. 스키마는 보통 에이전트가 작성하니, 이 페이지는 에이전트가 참고하거나 사람이 결과를 확인할 때 써요. - [CLI 레퍼런스](https://allob.app/docs/cli.md): allob CLI 의 모든 명령이에요. CLI 도움말과 같은 명령 정의에서 만들어서 늘 최신 버전과 같아요. 설명은 CLI 도움말처럼 영어예요. ## Optional - [Full docs and CLI manual in one file](https://allob.app/llms-full.txt): every page above plus the output of `allob help --all`