앱지기 앱지기 사용 안내
프로젝트 하나부터,
차근차근 돌보세요.
첫 연결부터 결과 확인까지의 기본 흐름과 전체 AI 점검·개별 위임, 개인 비서·백업을 안내합니다. 화면의 메뉴 이름을 따라 한 단계씩 진행하세요.
Mac용 배포 준비 중 · macOS 14 이상 · 안내 기준 2026년 10월
한 문제의 근거부터 준비하세요.
로컬 프로젝트 관리는 스토어·AI 연결 없이 시작할 수 있습니다. 실제 문제를 기록하고 목표·완료 조건을 정한 뒤, 필요한 자동화만 연결하세요. 아래 재현 화면은 앱의 SwiftUI 코드를 바탕으로 만들었으며 실제 작업을 실행하지 않습니다.
스토어를 연결할 때는 02–03단계도 진행하세요. AI 기능은 설치·인증된 구독 CLI와 사용 가능한 모델이 필요합니다.
프로젝트가 들어 있는 폴더를 연결합니다.
연결 설정 → 프로젝트 폴더 → 상위 폴더 추가
첫 화면은 입니다. 기본 작업 폴더를 확인하고, 다른 위치를 쓰면 에서 프로젝트들이 들어 있는 부모 폴더를 선택하세요. 목록이 달라지면 또는 ⌘R로 갱신합니다.
프로젝트 폴더
선택한 상위 폴더의 바로 아래 폴더들을 프로젝트로 점검합니다.
팁 · 자주 하는 실수
프로젝트 한 개의 폴더 자체를 고르면 그 안의 하위 폴더를 점검하게 됩니다. ‘연결 해제’는 원본 파일을 삭제하지 않습니다. Git 변경 수는 작업 상태이며 오류 수나 품질 점수가 아닙니다.
스토어를 쓴다면 API 키를 연결합니다.
연결 설정 → App Store Connect
에서 또는 를 선택합니다. 으로 파일을 고르거나, 발견된 키가 있으면 를 사용하세요. 파일명으로 채워진 를 확인하고, 팀 키는 도 입력한 뒤 을 누릅니다.
App Store Connect
팁 · 자주 하는 실수
API 조회는 브라우저 로그인 쿠키와 별개입니다. 키 폐기·권한 변경·네트워크 오류는 키 설정과 연결 상태를 확인하세요. 스토어 연결은 로컬 관리의 필수 조건이 아닙니다.
스토어 앱과 로컬 프로젝트를 연결합니다.
스토어 동기화 → 심사 · 출시 → 프로젝트 연결
상단의 를 누른 뒤 사이드바 를 엽니다. 에서 각 앱의 을 선택하고, 전체 동기화 성공 시각과 을 함께 살펴보세요.
심사부터 출시까지
플랫폼·버전별 현재 상태와 변경 이력을 확인하세요.
팁 · 자주 하는 실수
‘승인 · 출시 대기’, ‘판매 중’, ‘배포 가능’은 서로 다른 상태입니다. ‘배포 가능’만으로 한국 공개 출시를 단정하지 마세요. 거절 원문·심사 제출·출시·리뷰 답변은 ‘App Store Connect ↗’에서 직접 확인·처리합니다.
실제 문제를 피드백으로 기록합니다.
피드백함 → 피드백 기록 → 개선 작업 만들기
, , 과 를 작성하고 을 누릅니다. 출처는 ·· 중에서 고릅니다. 기록 카드의 로 연결된 작업을 만드세요.
피드백 기록
설명용 피드백 예시입니다.
원문과 출처가 기록된 뒤, 작업으로 연결합니다.
팁 · 자주 하는 실수
거절 상태만 보고 원인을 추측하지 말고 원문을 확인해 남기세요. 여러 기록은 ‘JSON 가져오기’로 가져올 수 있습니다. 날짜는 ISO 8601 형식을 사용하고 같은 출처에는 안정된 고유 ID와 실제 프로젝트 경로를 지정하세요. ‘미처리 / 처리됨 / 전체’ 필터로 범위를 좁힐 수 있습니다.
목표와 완료 조건이 있는 작업을 만듭니다.
개선 작업 → 새 개선 작업
····를 정합니다. , , 를 기록하고 하세요. 로 지시를 전달하거나, 실행 환경이 준비되면 을 사용할 수 있습니다.
개선 작업
팁 · 자주 하는 실수
제목만 있고 프로젝트나 완료 조건이 불분명하면 실행할 범위를 정하기 어렵습니다. 완료 단계는 작업이 끝났다는 판단과 근거를 함께 기록하세요.
자동 처리는 작업 사본을 선택된 CLI 제공자로 전송할 수 있으며 구독 사용량을 소비합니다. 필요한 개발 도구와 프로젝트 의존성도 준비되어 있어야 합니다.
자동 후보의 방향과 적용 설정을 확인합니다.
개선 후보 · 승인 → 방향 확인 · 승인
와 필터로 후보를 고릅니다. 을 누르고 에서 , , 을 검토·수정합니다. 필요하지 않은 후보는 하고 나중에 할 수 있습니다.
자동 점검 · 원본 적용 설정
예시는 켠 상태입니다. 실제 설정을 확인하세요.
개선 목표 · 처리 방향 · 범위 · 완료 조건
팁 · 자주 하는 실수
‘자동 점검 · 원본 적용 설정’의 ‘승인한 후보는 검증 후 원본에 자동 적용’을 먼저 확인하세요. 화면 검증 필수 후보는 ‘필수 화면 검증 대상 · 테스트 앱 경로 또는 로컬 주소’도 지정해야 합니다. GitHub Actions가 없다는 사실만으로 결함을 판단하지 않습니다.
작업 사본·관련 정보가 선택한 AI 제공자로 전달될 수 있습니다. 자동 적용을 켜면 검증 후 원본에 반영하므로 목표·범위·완료 조건을 승인 전에 확인하세요.
검증 결과와 원본 반영 여부를 따로 봅니다.
실행 · 결과 → 검증 근거 / 변경 파일 / 원본 적용 상태
으로 계정과 모델을 확인하고, 실행 카드의 , , 을 살펴보세요. 에서 상세 환경을 확인합니다. 실행 중에는 로 다음 단계의 지시를 보태거나 할 수 있습니다.
검증 근거와 변경 파일
팁 · 자주 하는 실수
충돌·검증 후 변경·권한 문제는 적용을 막습니다. ‘작업 사본 · 로그 열기’, ‘로그 열기’, ‘실행 데이터 폴더’에서 근거를 확인하세요. 중단은 사본과 로그를 보존합니다. 더 이상 조치할 필요가 없는 실패·중단 기록은 이유를 적어 ‘조치 불필요로 정리’하며 성공 이력으로 바꾸지 않습니다.
화면 검증이 필요한 작업은 지정한 대상의 단계·통과 결과·PNG/JPEG 이미지 근거가 필요합니다. Computer Use 연결 확인만으로 모든 화면이나 실기기 품질이 검증된 것은 아닙니다.
확인한 변경이 사본에 있습니다. 적용 대기 상태의 버튼으로 원본 반영을 진행합니다.
해당 변경이 원본에 반영된 상태입니다. 커밋·푸시·공개 출시와는 별도로 확인합니다.
전체 프로젝트에 AI 정밀 점검을 연결합니다.
전체 프로젝트 점검 → 모든 프로젝트 AI 점검 시작
으로 자료를 갱신한 뒤 을 누릅니다. 에서 , , 와 주기·한도를 조절하세요.
모든 프로젝트에 AI 정밀 점검을 연결하세요
읽기 전용 분석 → 개선 후보 생성 → 방향 확인·승인
팁 · 자주 하는 실수
각 프로젝트의 ‘점검 설정’에서 ‘프로젝트별 목표 · 실행 범위’, 전체 점검 제외·재포함, 프로젝트 AI 점검 일시 정지·재개를 관리합니다. ‘AI 점검 일시 정지’로 전체 예약 분석을 멈출 수 있습니다. 실패·중단도 최근 24시간 한도에 포함되며 AI 오류 뒤에는 예약 분석이 1시간 쉽니다. 높은 Mac 부하에서는 새 분석을 미룹니다.
정밀 분석은 프로젝트 사본과 연결 피드백을 Codex로 전송하고 구독 사용량을 소비합니다. 분석 사본은 UTF-8 파일 최대 2,000개, 파일당 256KB·전체 12MB로 제한합니다. 바이너리·미디어·의존성·키·심볼릭 링크 등을 제외하므로 부분 분석을 전체 검증으로 보지 마세요.
한 프로젝트를 지속적으로 맡깁니다.
AI 매니저 → 맡길 프로젝트 → AI에게 맡기기
개선 목표와 범위를 작성하고 를 확인합니다. 켜면 분석과 후보 생성에 한정합니다. 끄면 실행까지 맡길 수 있고 을 선택할 수 있습니다. 전송 범위·사용량·제외 범위를 읽은 뒤 를 누릅니다.
예시 프로젝트를 AI에게 맡기기
24시간마다 AI 점검 · 회당 개선 1건
새 위임의 기본값을 재현했습니다. 실행 전에 두 설정을 확인하세요.
팁 · 자주 하는 실수
새 개별 위임은 후보 생성 전용이 꺼져 있고 자동 적용이 켜진 기본값이므로 원하는 정책을 직접 확인하세요. 화면 변경에는 ‘화면 검증 대상 · 테스트 .app 경로 또는 로컬 주소 (선택)’를 지정합니다. ‘스킬 · Computer Use 활용 → 실제 연결 확인’으로 연결을 확인하세요. 위임을 일시 정지해도 실행 중인 개선은 ‘실행 · 결과 → 중단’에서 별도로 멈춰야 합니다.
프로젝트 사본·연결된 피드백·지정 테스트 화면이 Codex 및 선택된 Claude·Cursor 제공자로 전달될 수 있습니다. 외부 게시·배포·심사 제출, 운영 데이터·계정·보안 설정 변경은 위임 범위에 포함되지 않습니다.
오늘 일정과 할 일을 정리합니다.
나의 오늘 → 할 일 / 캘린더 / 미리 알림
에 입력하고 합니다. 과 완료 버튼, 로 목록을 관리하세요. 과 은 macOS 접근 권한을 요청합니다.
오늘도, 앱지기와 함께
팁 · 자주 하는 실수
다른 기기 동기화는 연결한 계정 설정에 따르며 앱지기 자체 기록 동기화가 아닙니다. ‘매일 첫 실행에 AI가 하루 계획 정리’는 선택 사항입니다. AI 계획은 요약 분석이며 실제 일정이나 파일을 자동 변경하지 않습니다.
‘AI로 하루 계획 정리’는 일정 제목·시간, 미완료 할 일·미리 알림, 프로젝트 작업 제목·단계와 Mac 상태 요약을 원격 Codex로 전송합니다.
Mac 상태와 큰 파일을 확인합니다.
내 Mac 관리 → 상태 점검 / 큰 파일 찾기
에서 저장 공간·장착 메모리··발열·켜진 시간을 살펴봅니다. 또는 으로 범위를 정하세요.
큰 파일 찾기
확인할 폴더를 골라 큰 파일을 살펴보세요.
팁 · 자주 하는 실수
기본 점검은 100MB 이상 파일을 최대 50개까지 표시합니다. 숨김 파일·앱 패키지 내부·심볼릭 링크는 제외하고 시간·개수 제한으로 일부만 확인할 수 있습니다. 시스템 부하는 CPU 사용률이 아닙니다. 휴지통 이동만으로 즉시 공간이 회수되거나 Mac이 빨라진다고 보장할 수 없습니다.
기록을 백업하고 점검을 마칩니다.
연결 설정 → 내 데이터 / 메뉴 막대 → 앱지기 점검
로 작업 기록을 보관하고 으로 누락된 기록을 추가합니다. 로 별도 데이터도 확인하세요. 창을 닫아도 앱 프로세스가 살아 있으면 메뉴 막대 에서 점검을 이어 갑니다.
내 데이터
프로젝트·심사 이력·피드백·개선 작업은 이 Mac에 저장됩니다.
앱지기 열기
정기 상태 점검 일시 정지 / 재개
앱지기 종료
팁 · 자주 하는 실수
JSON은 프로젝트·심사·피드백·작업 기록용이며 전체 앱 백업이 아닙니다. API 키는 제외되고 개인 비서·AI 위임·자동 실행·전체 점검 기록은 별도로 보관해야 합니다. 앱 종료·잠자기·로그아웃 중에는 예약 점검하지 않습니다. 재실행이 중단된 개선을 무조건 자동 재개하는 동작도 아닙니다.
막힐 때 다시 확인할 곳
문제 해결 · FAQ
새 프로젝트가 보이지 않아요.
‘연결 설정 → 프로젝트 폴더’에서 프로젝트들이 들어 있는 상위 폴더를 선택했는지 확인하고 ‘프로젝트 새로고침’을 누르세요. 바로 아래 폴더를 발견하는 구조입니다. 점검 실패 시에는 이전 목록을 유지하므로 오류와 마지막 확인 시각도 살펴보세요.
API 키 연결이나 동기화가 실패해요.
팀 키·개인 키 구분과 Key ID, 팀 키의 Issuer ID를 확인하세요. 키 폐기·조회 권한 변경·네트워크 오류도 살펴본 뒤 ‘연결 확인 · 동기화’를 누릅니다. API 실패 시 기존 데이터를 유지하고 부분 실패를 표시합니다. 브라우저 재로그인은 API 키 문제를 해결하지 않습니다.
심사 상태는 있는데 거절 이유가 없어요.
거절 메시지 원문은 자동 수집하지 않습니다. ‘심사 · 출시’의 ‘App Store Connect ↗’에서 직접 확인한 뒤 ‘피드백함 → 피드백 기록’으로 남기세요. TestFlight 의견·이메일·GitHub 이슈도 현재 자동 수집 대상이 아닙니다.
AI 점검이 바로 시작되지 않아요.
‘실행 · 결과 → CLI · 모델 확인’에서 설치·인증·모델·사용량을 확인하세요. 현재 정밀 분석과 하루 계획에는 Codex 구독에서 gpt-6-astra를 실제 사용할 수 있어야 합니다. 예약 점검은 한 번에 한 프로젝트이며 사용량, 점검 주기, 오류 후 대기, Mac 부하에 따라 늦어질 수 있습니다. 원본 폴더 부재·오래된 상태·부하 조회 실패도 새 분석을 막습니다.
전체 AI 점검을 켰는데 후보가 자동 실행되나요?
새 전체 AI 점검의 기본 흐름은 분석과 후보 생성까지입니다. ‘개선 후보 · 승인’에서 방향을 승인하면 실행으로 이어집니다. 이전에 개별 위임한 프로젝트는 기존 실행·자동 적용 정책을 유지하므로 해당 설정도 확인하세요.
검증이 끝났는데 원본은 그대로예요.
‘실행 · 결과’에서 원본 적용 여부를 확인하세요. 자동 적용을 끈 작업은 검증 후 기다립니다. ‘검증된 변경 원본에 적용’이 나타나는지 확인하고, 없다면 검증 상태·충돌·검증 후 변경·권한 오류를 살펴보세요. 사본 검증 완료와 원본 적용 완료는 별도입니다.
화면 검증 단계에서 멈췄어요.
테스트 앱이나 로컬 주소가 지정되어 있는지 확인하고 ‘스킬 · Computer Use 활용 → 실제 연결 확인’으로 도구 연결을 점검하세요. 필수 대상·단계·통과 결과·PNG/JPEG 근거가 없는 작업은 적용을 막습니다. 연결 성공만으로 해당 화면 검증이 끝난 것은 아닙니다.
위임을 일시 정지했는데 작업이 진행돼요.
‘위임 일시 정지’는 이후 분석을 멈춥니다. 이미 큐에 들어갔거나 실행 중인 개선은 ‘실행 · 결과 → 중단’으로 별도로 멈추세요. 중단 후에도 작업 사본과 로그가 남으므로 이유를 확인할 수 있습니다.
캘린더나 미리 알림이 보이지 않아요.
‘나의 오늘’에서 ‘캘린더 연결’ 또는 ‘macOS 미리 알림 연결’을 누르고 macOS 접근 권한을 확인하세요. 기본 계정의 캘린더·목록에 기록합니다. 다른 기기 표시 여부는 그 계정의 동기화 설정에 따르며 앱지기 자체 기록 동기화는 아닙니다.
백업을 복원했는데 모든 데이터가 돌아오지 않아요.
JSON 백업은 프로젝트·심사 이력·피드백·개선 작업 기록입니다. 현재 기록을 우선하고 누락된 ID를 추가합니다. API 키, 개인 비서·AI 위임·자동 실행·전체 점검 기록은 포함하지 않으므로 별도 보관 자료와 키체인 연결을 확인하세요.
데이터를 읽을 수 없다는 오류가 나타나요.
앱은 데이터 해독 실패 시 자동 저장을 막아 기존 자료를 보호합니다. ‘연결 설정 → 내 데이터 → 데이터 폴더 열기’에서 원본을 보존하고 별도 백업을 확인하세요. 복원 전에 현재 자료를 보관하고, 무작정 덮어쓰지 마세요.
창을 닫거나 Mac을 재시작해도 점검하나요?
창을 닫아도 프로세스가 살아 있으면 메뉴 막대에서 점검합니다. 앱 종료·잠자기·로그아웃 중에는 실행하지 않으며 로그인 시 자동 시작을 설정하지 않습니다. 재실행 뒤에는 기한이 지난 항목을 순서대로 점검하지만 중단된 개선을 무조건 자동 재개하지는 않습니다.
코드나 일정이 Mac 밖으로 나가나요?
일반 작업 기록은 로컬에 보관합니다. AI 기능 사용 시 필요한 프로젝트 사본·피드백·일정과 할 일 요약·지정 테스트 화면이 기능에 따라 해당 제공자로 전송될 수 있습니다. 파일 제외 규칙이 모든 비밀정보를 제거하는 것은 아니므로 범위를 확인하세요.
지금 다운로드하거나 문의할 수 있나요?
현재 Mac용 배포 준비 중이며 공개 다운로드와 가격·출시일은 미확정입니다. 현재 공개 문의 채널과 정식 개인정보처리방침은 확인되지 않았습니다. 이 안내의 데이터 처리 요약은 정식 방침을 대신하지 않습니다.
근거를 남기고,
다음 개선으로 이어 가세요.
프로젝트 하나의 실제 문제부터 시작하세요.