@skyreve/reve 1.0.2 → 1.0.4

package/README.md

@@ -1,44 +1,46 @@
 # Reve - SkyReve Platform Command Line Tool
 
-Reve는 SkyReve 플랫폼과 GitHub 저장소를 연결하여 프로젝트와 환경을 관리하는 커맨드라인 도구입니다.
+Reve is a comprehensive command line tool that connects the SkyReve platform with GitHub repositories to manage projects, environments, and deployments seamlessly. It provides a complete workflow for syncing local development with cloud environments.
 
-## 📋 목차 (Table of Contents)
+## 📋 Table of Contents
 
-1. [설치 방법](#1-설치-방법-installation)
-2. [개발 환경 설정](#2-개발-환경-설정-development-setup)
-3. [빌드](#3-빌드-build)
-4. [환경별 바이너리 설명](#4-환경별-바이너리-설명)
-5. [Reve CLI 사용법](#5-reve-cli-사용법-using-reve-cli)
-6. [개발 도구](#6-개발-도구-development-tools)
+1. [Installation](#1-installation)
+2. [Development Setup](#2-development-setup)
+3. [Build](#3-build)
+4. [Environment Configuration](#4-environment-configuration)
+5. [Using Reve CLI](#5-using-reve-cli)
+6. [Development Tools](#6-development-tools)
+7. [Publishing to npm](#7-publishing-to-npm)
+8. [Project Structure](#8-project-structure)
 
 ---
 
-## **1. 설치 방법 (Installation)**
+## **1. Installation**
 
-### **1.1 npm을 통한 설치 (권장)**
+### **1.1 Install via npm (Recommended)**
 
-다른 npm 프로젝트에서 Reve CLI를 사용하려면:
+To use Reve CLI in other npm projects:
 
 ```bash
 npm install @skyreve/reve
 ```
 
-설치 후 `npx reve` 명령어로 실행할 수 있습니다:
+After installation, you can run it using `npx reve`:
 
 ```bash
 npx reve --help
 npx reve start
 ```
 
-### **1.2 글로벌 설치**
+### **1.2 Global Installation**
 
-전역적으로 설치하려면:
+To install globally:
 
 ```bash
 npm install -g @skyreve/reve
 ```
 
-설치 후 `reve` 명령어로 직접 실행할 수 있습니다:
+After installation, you can run it directly with the `reve` command:
 
 ```bash
 reve --help
@@ -47,11 +49,11 @@ reve start
 
 ---
 
-## **2. 개발 환경 설정 (Development Setup)**
+## **2. Development Setup**
 
-### **2.1 Go 설치**
+### **2.1 Install Go**
 
-Reve CLI는 **Go**를 필요로 합니다. Go가 설치되지 않았다면 아래 명령어로 설치하세요:
+Reve CLI requires **Go**. If Go is not installed, install it using the following commands:
 
 **macOS:**
 
@@ -71,11 +73,11 @@ sudo yum install golang
 ```
 
 **Windows:**
-[Go 공식 웹사이트](https://golang.org/dl/)에서 설치 파일을 다운로드하여 설치하세요.
+Download and install from the [official Go website](https://golang.org/dl/).
 
-### **2.2 프로젝트 초기화**
+### **2.2 Initialize Project**
 
-프로젝트를 클론하고 의존성을 설치합니다:
+Clone the project and install dependencies:
 
 ```bash
 git clone git@github.com:SkyReve/reve-cli.git
@@ -85,38 +87,38 @@ go mod tidy
 
 ---
 
-## **3. 빌드 (Build)**
+## **3. Build**
 
-### **3.1 기본 빌드**
+### **3.1 Basic Build**
 
-현재 OS용 바이너리를 빌드하려면:
+To build a binary for the current OS:
 
 ```bash
 make
 ```
 
-또는:
+or:
 
 ```bash
 make build
 ```
 
-빌드가 완료되면 `bin/` 디렉토리에 `reve` 바이너리가 생성됩니다:
+After building, the `reve` binary will be created in the `bin/` directory:
 
 ```bash
 bin/
 └── reve
 ```
 
-### **3.2 모든 OS(Linux, macOS, Windows)용 바이너리 빌드**
+### **3.2 Build for All Operating Systems**
 
-모든 플랫폼용 바이너리를 빌드하려면:
+To build binaries for all platforms (Linux, macOS, Windows):
 
 ```bash
 make build-all
 ```
 
-모든 OS에 대한 바이너리를 빌드하면 아래와 같은 구조로 파일이 생성됩니다:
+Building for all OS will create files in the following structure:
 
 ```bash
 bin/
@@ -125,204 +127,231 @@ bin/
 └── windows/reve.exe
 ```
 
-### **3.3 빌드된 바이너리 확인**
+### **3.3 Verify Built Binaries**
 
-빌드된 바이너리는 `bin/` 디렉토리에 저장됩니다. 확인하려면:
+Built binaries are stored in the `bin/` directory. To check:
 
 ```bash
 ls -la bin/
-# 또는
+# or
 tree bin/
 ```
 
 ---
 
-## **4. 환경별 실행**
+## **4. Environment Configuration**
 
-Reve CLI는 환경 변수 `REVE_ENV`를 통해 다른 API 서버를 사용합니다.
+Reve CLI uses the `REVE_ENV` environment variable to connect to different API servers.
 
-### **🔹 개발 환경 (dev)**
+### **🔹 Development Environment (dev)**
 
 ```bash
 make run-dev
-# 또는
+# or
 REVE_ENV=dev ./bin/reve
 ```
 
 - **BaseURL:** `http://localhost:8000`
 - **GitHub App:** [https://github.com/apps/skyreve-staging](https://github.com/apps/skyreve-staging)
-- **설명:** 개발 환경용입니다. 새로운 기능을 테스트하고 디버깅할 때 사용합니다.
+- **Description:** For development environment. Used for testing new features and debugging.
 
-### **🔹 스테이징 환경 (staging)**
+### **🔹 Staging Environment (staging)**
 
 ```bash
 make run-staging
-# 또는
+# or
 REVE_ENV=staging ./bin/reve
 ```
 
 - **BaseURL:** `https://api.hellreve.world`
 - **GitHub App:** [https://github.com/apps/skyreve-staging](https://github.com/apps/skyreve-staging)
-- **설명:** 스테이징 환경용입니다. 운영 환경과 유사한 조건에서 최종 QA 및 검증에 사용됩니다.
+- **Description:** For staging environment. Used for final QA and validation under conditions similar to production.
 
-### **🔹 운영 환경 (production)**
+### **🔹 Production Environment (production)**
 
 ```bash
 make run-production
-# 또는
+# or
 ./bin/reve
 ```
 
 - **BaseURL:** `https://api.skyreve.cloud`
 - **GitHub App:** [https://github.com/apps/skyreve](https://github.com/apps/skyreve)
-- **설명:** 운영(프로덕션) 환경용입니다. 실제 사용자에게 제공되는 서비스 환경에서 사용됩니다.
+- **Description:** For production environment. Used in the actual service environment provided to real users.
 
 ---
 
-## **5. Reve CLI 사용법 (Using `reve`)**
+## **5. Using Reve CLI**
 
-### **5.1 npm을 통한 실행 (권장)**
+### **5.1 Running via npm (Recommended)**
 
-npm으로 설치한 경우:
+When installed via npm:
 
 ```bash
 npx reve [COMMAND] [OPTIONS]
-# 또는 글로벌 설치한 경우
+# or if installed globally
 reve [COMMAND] [OPTIONS]
 ```
 
-### **5.2 바이너리 직접 실행**
+### **5.2 Running Binary Directly**
 
-빌드된 바이너리를 직접 실행하는 경우:
+When running the built binary directly:
 
 ```bash
-# 개발 환경
+# Development environment
 REVE_ENV=dev ./bin/reve [COMMAND] [OPTIONS]
 
-# 스테이징 환경
+# Staging environment
 REVE_ENV=staging ./bin/reve [COMMAND] [OPTIONS]
 
-# 운영 환경 (기본값)
+# Production environment (default)
 ./bin/reve [COMMAND] [OPTIONS]
 ```
 
-### **5.3 도움말 확인**
+### **5.3 Getting Help**
 
 ```bash
 reve --help
-# 또는
+# or
 npx reve --help
 ```
 
-### **5.4 주요 명령어**
+### **5.4 Main Commands**
 
-#### **🔹 기본 명령어**
+#### **🔹 Basic Commands**
 
-| 명령어               | 설명                                   |
-| -------------------- | -------------------------------------- |
-| `reve start`         | 완전한 설정 과정을 거쳐 환경 관리 시작 |
-| `reve login [email]` | SkyReve 플랫폼에 로그인                |
-| `reve project`       | 작업할 SkyReve 프로젝트 선택           |
+| Command              | Description                                                                     |
+| -------------------- | ------------------------------------------------------------------------------- |
+| `reve start`         | **Quick Start**: Complete 6-step setup process and start environment management |
+| `reve login [email]` | Login to SkyReve platform                                                       |
+| `reve project`       | Select/create SkyReve project to work with                                      |
 
-#### **🔹 환경 관리 명령어 (`reve env`)**
+#### **🔹 Environment Management Commands (`reve env`)**
 
-| 명령어                     | 설명                                                      |
-| -------------------------- | --------------------------------------------------------- |
-| `reve env`                 | 대화형 환경 관리 시작 (`reve env start`와 동일한 동작)    |
-| `reve env start`           | 대화형 환경 관리 시작                                     |
-| `reve env info`            | 프로젝트 정보, Git 저장소 정보, GitHub App 설치 상태 확인 |
-| `reve env list`            | 모든 Reve 환경과 연결된 GitHub 브랜치 정보 나열           |
-| `reve env link <reve_env>` | GitHub 브랜치를 특정 Reve 환경에 연결                     |
-| `reve env sync`            | 현재 저장소 브랜치를 Reve 환경과 동기화                   |
-| `reve env deploy`          | 현재 저장소 브랜치를 Reve 환경에 배포                     |
+| Command                    | Description                                                                 |
+| -------------------------- | --------------------------------------------------------------------------- |
+| `reve env`                 | Start interactive environment management (same as `reve env start`)         |
+| `reve env start`           | Start interactive environment management                                    |
+| `reve env info`            | Check project info, Git repository info, and GitHub App installation status |
+| `reve env list`            | List all Reve environments with linked GitHub branch information            |
+| `reve env link <reve_env>` | Link GitHub branch to specific Reve environment                             |
+| `reve env sync`            | Sync current repository branch with Reve environment                        |
+| `reve env deploy`          | Deploy current repository branch to Reve environment                        |
 
-#### **🔹 GitHub 관련 명령어 (`reve github`)**
+#### **🔹 GitHub Commands (`reve github`)**
 
-| 명령어                | 설명                                   |
-| --------------------- | -------------------------------------- |
-| `reve github login`   | GitHub에 Device Flow를 사용하여 로그인 |
-| `reve github install` | 현재 저장소에 GitHub App 설치          |
+| Command               | Description                               |
+| --------------------- | ----------------------------------------- |
+| `reve github login`   | Login to GitHub using Device Flow         |
+| `reve github install` | Install GitHub App for current repository |
 
-### **5.5 사용 예시**
+### **5.5 Usage Examples**
 
-#### **처음 사용하는 경우 (권장)**
+#### **First-time Setup (Recommended)**
 
 ```bash
-# 1. 완전한 설정 과정을 거쳐 시작
+# 1. Complete 6-step setup process (Quick Start)
 reve start
 ```
 
-이 명령어는 다음 과정을 자동으로 수행합니다:
+This **Quick Start** command automatically performs the following 6 steps:
 
-1. SkyReve 플랫폼 로그인
-2. 프로젝트 선택/생성
-3. GitHub 로그인
-4. GitHub App 설치
-5. 환경 관리 시작
+1. **🔐 Step 1/6**: Login to SkyReve platform
+2. **📁 Step 2/6**: Select/create a project
+3. **🐙 Step 3/6**: Login to GitHub
+4. **🔧 Step 4/6**: Install GitHub App
+5. **📦 Step 5/6**: Link GitHub branch to Reve environment
+6. **🚀 Step 6/6**: Start syncing Reve environment
 
-#### **개별 설정**
+After completion, you'll see: `🎉 All setup steps completed successfully!`
+
+#### **Individual Setup**
 
 ```bash
-# 1. SkyReve 플랫폼에 로그인
+# 1. Login to SkyReve platform
 reve login your-email@example.com
 
-# 2. 프로젝트 선택
+# 2. Select project
 reve project
 
-# 3. GitHub에 로그인
+# 3. Login to GitHub
 reve github login
 
-# 4. GitHub App 설치
+# 4. Install GitHub App
 reve github install
 
-# 5. 환경 관리 시작
+# 5. Start environment management
 reve env start
 ```
 
-#### **일상적인 사용**
+#### **Daily Usage**
 
 ```bash
-# 환경 목록 확인
+# Check environment list
 reve env list
 
-# 특정 환경에 브랜치 연결
+# Link branch to specific environment
 reve env link main
 
-# 현재 브랜치 동기화
+# Sync current branch
 reve env sync
 
-# 현재 브랜치 배포
+# Deploy current branch
 reve env deploy
 
-# 강제 배포 (충돌이 있어도)
+# Force deploy (even with conflicts)
 reve env deploy --force
 ```
 
+### **5.6 Advanced Features**
+
+#### **🔹 File Generation**
+
+The `reve env sync` command automatically generates the following files in your project:
+
+- **Settings**: `src/settings.yaml` - Project configuration
+- **Tables**: `src/tables/*.yaml` - Database table definitions
+- **APIs**: `src/apis/*.yaml` + `src/apis/*.apy` - API endpoint definitions and view code
+- **Libraries**: `src/libs/*.apy` - Code library implementations
+
+#### **🔹 Environment Management**
+
+- **Multiple Environments**: Support for dev, staging, production environments
+- **Branch Linking**: Link specific Git branches to Reve environments
+- **Auto Deploy**: Configure automatic deployment on Git push
+- **Conflict Resolution**: Handle deployment conflicts with force option
+
+#### **🔹 GitHub Integration**
+
+- **Device Flow Authentication**: Secure GitHub login without storing passwords
+- **GitHub App Installation**: Automated GitHub App setup for repositories
+- **Repository Linking**: Connect GitHub repositories to SkyReve projects
+
 ---
 
-## **6. 개발 도구 (Development Tools)**
+## **6. Development Tools**
 
-### **6.1 정리 (Clean)**
+### **6.1 Clean**
 
-불필요한 빌드 파일을 정리하려면:
+To clean up unnecessary build files:
 
 ```bash
 make clean
 ```
 
-### **6.2 테스트 및 린트**
+### **6.2 Test and Lint**
 
 ```bash
-# 테스트 실행
+# Run tests
 make test
 
-# 린트 실행
+# Run linter
 make lint
 ```
 
-### **6.3 개발 모드 실행**
+### **6.3 Development Mode**
 
-개발 중 빠른 테스트를 위해:
+For quick testing during development:
 
 ```bash
 make run
@@ -330,42 +359,251 @@ make run
 
 ---
 
-## **7. 프로젝트 구조**
+## **7. Publishing to npm**
+
+### **7.1 Prerequisites**
+
+Before publishing to npm, ensure you have:
+
+1. **npm account**: Create an account at [npmjs.com](https://www.npmjs.com/)
+2. **npm CLI**: Install npm CLI globally if not already installed
+3. **Authentication**: Login to npm using `npm login`
+
+### **7.2 Build Process**
+
+Before publishing, you need to build the binaries for all platforms:
+
+```bash
+# Build binaries for all platforms
+npm run build
+# or
+make build-all
+```
+
+This creates binaries in the following structure:
+
+```
+bin/
+├── linux/reve
+├── darwin/reve
+└── windows/reve.exe
+```
+
+### **7.3 Version Management**
+
+Update the version in `package.json` before publishing:
+
+```bash
+# Patch version (1.0.0 -> 1.0.1)
+npm version patch
+
+# Minor version (1.0.0 -> 1.1.0)
+npm version minor
+
+# Major version (1.0.0 -> 2.0.0)
+npm version major
+```
+
+### **7.4 Publishing Steps**
+
+1. **Login to npm**:
+
+   ```bash
+   npm login
+   ```
+
+2. **Build binaries**:
+
+   ```bash
+   npm run build
+   ```
+
+3. **Publish to npm**:
+
+   ```bash
+   npm publish
+   ```
+
+### **7.5 Publishing to Different Registries**
+
+#### **Publishing to npm (Public)**
+
+```bash
+npm publish
+```
+
+#### **Publishing to npm (Private)**
+
+```bash
+npm publish --access private
+```
+
+#### **Publishing to Custom Registry**
+
+```bash
+npm publish --registry https://your-registry.com
+```
+
+### **7.6 Verification**
+
+After publishing, verify the package:
+
+```bash
+# Check package info
+npm info @skyreve/reve
+
+# Test installation
+npm install @skyreve/reve
+npx reve --help
+```
+
+### **7.7 Automated Publishing**
+
+For automated publishing, you can use GitHub Actions or similar CI/CD tools:
+
+```yaml
+# .github/workflows/publish.yml
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: "16"
+          registry-url: "https://registry.npmjs.org"
+      - run: npm ci
+      - run: npm run build
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+
+### **7.8 Troubleshooting**
+
+#### **Common Issues:**
+
+1. **"Package already exists"**: Update version number
+2. **"Authentication failed"**: Run `npm login` again
+3. **"Binary not found"**: Ensure `npm run build` completed successfully
+4. **"Permission denied"**: Check npm permissions for the package
+
+#### **Useful Commands:**
+
+```bash
+# Check who you're logged in as
+npm whoami
+
+# Check package permissions
+npm access ls-packages
+
+# Unpublish (only within 24 hours)
+npm unpublish @skyreve/reve@version
+```
+
+---
+
+## **8. Project Structure**
 
 ```
 reve-cli/
-├── cmd/                    # 명령어 정의
-│   ├── root.go            # 루트 명령어
-│   ├── start.go           # 완전한 설정 시작 명령어
-│   ├── login.go           # 로그인 명령어
-│   ├── project.go         # 프로젝트 선택 명령어
-│   ├── env.go             # 환경 관리 명령어
-│   ├── github.go          # GitHub 관련 명령어
-│   ├── env/               # 환경 관리 서브 명령어
-│   │   ├── start.go       # 환경 관리 시작
-│   │   ├── info.go        # 프로젝트 정보 확인
-│   │   ├── list.go        # 환경 목록
-│   │   ├── link.go        # 브랜치 연결
-│   │   ├── sync.go        # 동기화
-│   │   ├── deploy.go      # 배포
-│   │   └── common.go      # 공통 함수
-│   └── github/            # GitHub 서브 명령어
-│       ├── login.go       # GitHub 로그인
-│       └── install.go     # GitHub App 설치
-├── internal/              # 내부 패키지
-│   ├── config/           # 설정 관리
-│   ├── constants/        # 상수 정의
-│   ├── git/              # Git 관련 기능
-│   ├── github/           # GitHub API
-│   ├── logger/           # 로깅
-│   └── reve/             # Reve API 및 유틸리티
-├── main.go               # 메인 진입점
-├── go.mod               # Go 모듈 정의
-└── README.md           # 이 파일
+├── cmd/                    # Command definitions
+│   ├── root.go            # Root command with logging and config
+│   ├── start.go           # Complete setup start command (6-step process)
+│   ├── login.go           # SkyReve platform login with email/password
+│   ├── project.go         # Project selection/creation
+│   ├── env.go             # Environment management command group
+│   ├── github.go          # GitHub related commands group
+│   ├── env/               # Environment management sub-commands
+│   │   ├── start.go       # Interactive environment management
+│   │   ├── info.go        # Project and environment information
+│   │   ├── list.go        # List all environments with branch info
+│   │   ├── link.go        # Link GitHub branch to environment
+│   │   ├── sync.go        # Sync files (settings, tables, APIs, libs)
+│   │   ├── deploy.go      # Deploy to environment
+│   │   └── common.go      # Common environment functions
+│   └── github/            # GitHub sub-commands
+│       ├── login.go       # GitHub Device Flow authentication
+│       └── install.go     # GitHub App installation
+├── internal/              # Internal packages
+│   ├── api/              # SkyReve API client and data structures
+│   ├── config/           # Configuration management (.reve directory)
+│   ├── constants/        # Application constants
+│   ├── gen/              # File generation (YAML files for tables, APIs, etc.)
+│   ├── git/              # Git repository operations
+│   ├── github/           # GitHub API client
+│   ├── http/             # HTTP client utilities
+│   ├── logger/           # Logging system
+│   ├── reve/             # SkyReve platform utilities
+│   └── cmd_common/       # Common command utilities
+├── scripts/              # Node.js wrapper scripts
+│   └── reve.js           # Cross-platform binary launcher
+├── bin/                  # Built binaries (platform-specific)
+├── samples/              # Example files and configurations
+├── tests/                # Test files
+├── main.go               # Application entry point
+├── package.json          # npm package configuration
+├── go.mod               # Go module definition
+├── Makefile             # Build and development commands
+└── README.md           # This file
 ```
 
+### **8.1 Key Components**
+
+#### **🔹 Command Structure**
+
+- **Cobra Framework**: Modern CLI framework with subcommands and flags
+- **Persistent Flags**: Global logging and configuration options
+- **Command Groups**: Organized commands (`env`, `github`)
+
+#### **🔹 Configuration Management**
+
+- **`.reve` Directory**: Local configuration storage
+- **Multi-Environment**: Support for dev/staging/production configs
+- **Secure Storage**: Encrypted token storage
+
+#### **🔹 File Generation System**
+
+- **YAML Configuration**: Human-readable configuration files for settings, tables, and API definitions
+- **APY Implementation**: Actual implementation code files for APIs and libraries
+- **Modular Structure**: Separate files for tables, APIs, libraries
+- **Template System**: Consistent file generation across environments
+
+#### **🔹 GitHub Integration**
+
+- **Device Flow**: Secure OAuth without password storage
+- **App Installation**: Automated GitHub App setup
+- **Repository Linking**: Connect repos to SkyReve projects
+
+---
+
+## **9. Requirements**
+
+- **Node.js**: 14.0.0 or higher
+- **Go**: Latest stable version
+- **Supported OS**: macOS, Linux, Windows
+- **Supported Architectures**: x64, arm64
+
+---
+
+## **10. License**
+
+MIT
+
+---
+
+## **11. Support**
+
+For issues or questions, please contact us through [GitHub Issues](https://github.com/SkyReve/reve-cli/issues).
+
 ---
 
-### **🛠 이제 SkyReve command line tool: `reve`를 사용할 준비가 완료되었습니다! 🚀**
+### **🛠 You're now ready to use the SkyReve command line tool: `reve`! 🚀**
 
-더 자세한 정보나 도움이 필요하시면 [GitHub Issues](https://github.com/SkyReve/reve-cli/issues)에서 문의해 주세요.
+For more detailed information or help, please refer to [GitHub Issues](https://github.com/SkyReve/reve-cli/issues).

package/README.npm.md

@@ -1,70 +1,123 @@
 # Reve
 
-Reve는 Reve 플랫폼을 위한 커맨드라인 도구입니다.
+Reve is a command line tool for the SkyReve platform that connects your GitHub repositories with SkyReve projects and environments.
 
-## 설치 방법
+## Installation
 
-### npm을 통한 설치 (권장)
+### Install via npm (Recommended)
+
+To use Reve in your npm project:
 
-다른 npm 프로젝트에서 Reve를 사용하려면:
 ```bash
 npm install @skyreve/reve
 ```
 
-설치 후 `npx reve` 명령어로 실행할 수 있습니다:
+After installation, you can run it using `npx reve`:
+
 ```bash
 npx reve --help
-npx reve status
-npx reve init
+npx reve start
 ```
 
-### 글로벌 설치
+### Global Installation
+
+To install globally:
 
-전역적으로 설치하려면:
 ```bash
 npm install -g @skyreve/reve
 ```
 
-설치 후 `reve` 명령어로 직접 실행할 수 있습니다:
+After installation, you can run it directly with the `reve` command:
+
 ```bash
 reve --help
-reve status
-reve init
+reve start
+```
+
+## Quick Start
+
+The easiest way to get started with Reve is using the **Quick Start** command:
+
+```bash
+reve start
 ```
 
-## 사용법
+This command will guide you through a complete 6-step setup process:
+
+1. **🔐 Step 1/6**: Login to SkyReve platform
+2. **📁 Step 2/6**: Select/create a project
+3. **🐙 Step 3/6**: Login to GitHub
+4. **🔧 Step 4/6**: Install GitHub App
+5. **📦 Step 5/6**: Link GitHub branch to Reve environment
+6. **🚀 Step 6/6**: Start syncing Reve environment
+
+After completion, you'll see: `🎉 All setup steps completed successfully!`
+
+## Usage
 
-### 기본 명령어
+### Main Commands
 
-| 명령어 | 설명 |
-|--------|------|
-| `reve init` | SkyReve 프로젝트 초기화 |
-| `reve sync` | 원격 데이터와 동기화 |
-| `reve status` | 프로젝트 상태 확인 |
-| `reve deploy` | 프로젝트 배포 |
-| `reve switch` | 프로젝트 및 브랜치 전환 |
-| `reve github-init` | GitHub 연동 초기화 |
-| `reve github-link` | GitHub 저장소 연결 |
-| `reve github-unlink` | GitHub 저장소 연결 해제 |
+| Command               | Description                                    |
+| --------------------- | ---------------------------------------------- |
+| `reve start`          | **Quick Start**: Complete 6-step setup process |
+| `reve login [email]`  | Login to SkyReve platform                      |
+| `reve project`        | Select/create SkyReve project                  |
+| `reve env`            | Start interactive environment management       |
+| `reve env list`       | List all Reve environments                     |
+| `reve env link <env>` | Link GitHub branch to Reve environment         |
+| `reve env sync`       | Sync current branch with Reve environment      |
+| `reve env deploy`     | Deploy current branch to Reve environment      |
+| `reve github login`   | Login to GitHub using Device Flow              |
+| `reve github install` | Install GitHub App for current repository      |
 
-### 도움말 확인
+### Getting Help
 
 ```bash
 reve --help
-# 또는
+# or
 npx reve --help
 ```
 
-## 요구사항
+### Daily Usage Examples
 
-- Node.js 14.0.0 이상
-- 지원 OS: macOS, Linux, Windows
-- 지원 아키텍처: x64, arm64
+```bash
+# Check environment list
+reve env list
+
+# Link branch to specific environment
+reve env link main
+
+# Sync current branch
+reve env sync
+
+# Deploy current branch
+reve env deploy
+
+# Force deploy (even with conflicts)
+reve env deploy --force
+```
 
-## 라이선스
+## Requirements
+
+- Node.js 14.0.0 or higher
+- Supported OS: macOS, Linux, Windows
+- Supported Architectures: x64, arm64
+
+## License
 
 MIT
 
-## 지원
+## Support
+
+If you encounter any issues or have questions, please report them through [GitHub Issues](https://github.com/skyreve/reve-cli/issues).
+
+## What is SkyReve?
+
+SkyReve is a platform that allows you to manage projects and environments by linking them with GitHub repositories and branches. Reve CLI makes it easy to:
+
+- Connect your GitHub repositories to SkyReve projects
+- Manage different environments (development, staging, production)
+- Deploy your code to various environments
+- Sync your local development with cloud environments
 
-문제가 있거나 질문이 있으시면 [GitHub Issues](https://github.com/skyreve/reve-cli/issues)를 통해 문의해주세요.
+Get started today with `reve start`! 🚀

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyreve/reve",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Reve - A command line tool for Reve platform",
   "main": "index.js",
   "scripts": {

package/scripts/reve.js

@@ -9,21 +9,21 @@ const os = require('os');
 const getBinaryPath = () => {
   const platform = os.platform();
   const arch = os.arch();
-  
+
   // 플랫폼별 디렉토리 매핑
   const platformMap = {
     'darwin': 'darwin',
-    'linux': 'linux', 
+    'linux': 'linux',
     'win32': 'windows'
   };
-  
+
   const platformDir = platformMap[platform] || 'linux';
-  const binDir = path.join(__dirname, '..', 'bin', 'release', platformDir);
-  
+  const binDir = path.join(__dirname, '..', 'bin', platformDir);
+
   // Windows의 경우 .exe 확장자 추가
   const binaryName = platform === 'win32' ? 'reve.exe' : 'reve';
   const binaryPath = path.join(binDir, binaryName);
-  
+
   return binaryPath;
 };
 
@@ -42,14 +42,14 @@ const runBinary = (binaryPath, args) => {
     stdio: 'inherit',
     cwd: process.cwd()
   };
-  
+
   const child = spawn(binaryPath, args, options);
-  
+
   child.on('error', (error) => {
     console.error(`❌ Reve binary execution error: ${error.message}`);
     process.exit(1);
   });
-  
+
   child.on('exit', (code) => {
     process.exit(code);
   });
@@ -58,17 +58,17 @@ const runBinary = (binaryPath, args) => {
 // 메인 실행 함수
 const main = () => {
   const binaryPath = getBinaryPath();
-  
+
   // 바이너리 존재 확인
   if (!checkBinaryExists(binaryPath)) {
     console.error(`❌ Reve binary not found: ${binaryPath}`);
     console.error('Please run build first: npm run build');
     process.exit(1);
   }
-  
+
   // 명령행 인수 전달 (node와 스크립트 이름 제외)
   const args = process.argv.slice(2);
-  
+
   // 바이너리 실행
   runBinary(binaryPath, args);
 };