이런 경험 있으신가요?

Have You Ever Experienced This?

CLI 도구를 사용하다가 이런 메시지를 보신 적 있으시죠?

Have you ever seen this message while using a CLI tool?

🚀 Update available: 0.1.13

"나중에 해야지~" 하고 넘어갔다가, 몇 주 후에 버그를 발견하고 이슈를 올리면...

You think "I'll do it later~" and skip it, then weeks later you discover a bug and file an issue...

"최신 버전으로 업데이트하셨나요? 해당 버그는 v1.13.0에서 이미 수정되었어요."

"Did you update to the latest version? That bug was already fixed in v1.13.0."

그제서야 "아, 그때 그 알림 무시했는데..." 하며 부랴부랴 업데이트를 하게 됩니다.

Only then do you think "Oh, I ignored that notification..." and hurry to update.

이런 번거로움, 이제 없애고 싶었습니다.

We wanted to eliminate this hassle.

Orbitron은 이제 스스로 조용히 업데이트됩니다. 간단하게 설정하고 평소처럼 실행하기만 하면 돼요!

Orbitron now updates itself quietly. Just set it up once and run it as usual!

무엇이 달라졌나요?

What Has Changed?

# 1. Orbitron 다운로드 페이지 방문
# 2. 최신 버전 다운로드
# 3. 실행 권한 설정
# 4. PATH에 추가
# (매번 이 과정을 반복...)

# 1. Visit Orbitron download page
# 2. Download latest version
# 3. Set execute permissions
# 4. Add to PATH
# (Repeat this process every time...)

# 설치 시 자동 업데이트를 활성화했다면
$ orbitron
# 그냥 실행하세요!
# 백그라운드에서 자동으로 최신 버전을 다운로드합니다.
# 다음 번 실행할 때 최신 버전이 적용됩니다.

# If you enabled auto-update during installation
$ orbitron
# Just run it!
# Automatically downloads the latest version in the background.
# Next time you run it, the latest version will be applied.

핵심 개선사항:

Key Improvements:

• 자동 다운로드: 백그라운드에서 조용히 업데이트 확인 및 다운로드
• 작업 방해 없음: 업데이트 중에도 Orbitron을 계속 사용할 수 있습니다
• 중복 다운로드 방지: 이미 받은 버전은 다시 다운로드하지 않습니다
• 안전한 관리: 체크섬 검증, 충돌 방지, 자동 롤백
• 사용자 선택권: 언제든지 활성화/비활성화 가능

• Automatic Download: Quietly checks and downloads updates in the background
• No Disruption: Continue using Orbitron while it updates
• Prevent Duplicate Downloads: Don't re-download versions you already have
• Safe Management: Checksum verification, conflict prevention, automatic rollback
• User Choice: Enable/disable anytime

자동 업데이트 작동 방식

How Auto-Update Works

$ orbitron

orbitron> 안녕하세요
AI: 안녕하세요! 무엇을 도와드릴까요?

# (백그라운드에서 v0.1.13 다운로드 중...)

orbitron> 프로젝트 분석해줘
AI: 네, 프로젝트를 분석하겠습니다...

# (작업하는 동안 업데이트가 완료됨)

orbitron> Hello
AI: Hello! How can I help you?

# (Downloading v0.1.13 in background...)

orbitron> Analyze the project
AI: Sure, I'll analyze the project...

# (Update completes while you work)

$ orbitron --version
v0.1.13  # 최신 버전으로 업데이트됨!

$ orbitron --version
v0.1.13  # Updated to latest version!

얼마나 자주 체크하나요?

How Often Does It Check?

6시간마다 한 번씩 업데이트를 확인합니다.

It checks for updates once every 6 hours.

• API 서버에 부담을 주지 않습니다
• 네트워크 사용량을 최소화합니다
• 하루에 최대 4번만 체크 (대부분 눈치채지 못합니다!)

• Does not burden the API server
• Minimizes network usage
• Maximum 4 checks per day (you won't even notice!)

자동 업데이트 설정하기

Setting Up Auto-Update

초기 설정 (설치 시)

Initial Setup (During Installation)

처음 Orbitron을 설치하면 자동 업데이트 설정을 물어봅니다:

When you first install Orbitron, it asks about auto-update settings:

$ curl -fsSL https://orbitron.alphacode.ai/api/install.sh | bash

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Auto-Update Configuration
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Would you like to enable automatic updates?
You can change this setting later with: orbitron config set autoUpdate <true|false>

Enable auto-update? (Y/n):

• Y, yes, 또는 Enter: 자동 업데이트 활성화 (권장)
• N 또는 n: 수동으로 업데이트

• Y, yes, or Enter: Enable auto-update (recommended)
• N or n: Update manually

언제든지 변경 가능

Change Anytime

설치 후에도 언제든지 설정을 변경할 수 있습니다:

You can change settings anytime after installation:

# 자동 업데이트 활성화
orbitron config set autoUpdate true

# 자동 업데이트 비활성화
orbitron config set autoUpdate false

# 현재 설정 확인
orbitron config get autoUpdate

# 모든 설정 보기
orbitron config list

# Enable auto-update
orbitron config set autoUpdate true

# Disable auto-update
orbitron config set autoUpdate false

# Check current setting
orbitron config get autoUpdate

# View all settings
orbitron config list

환경 변수로 임시 제어

Temporary Control with Environment Variables

개발 중이거나 특정 세션에서만 자동 업데이트를 끄고 싶다면:

If you're developing or want to disable auto-update for a specific session:

# 현재 세션에서만 자동 업데이트 활성화
export ORBITRON_AUTO_UPDATE=true

# 현재 세션에서만 자동 업데이트 비활성화
export ORBITRON_AUTO_UPDATE=false

# Enable auto-update for current session only
export ORBITRON_AUTO_UPDATE=true

# Disable auto-update for current session only
export ORBITRON_AUTO_UPDATE=false

1. ORBITRON_AUTO_UPDATE 환경 변수 (최우선)
   ↓ (설정 안 됨)
2. ~/.orbitron.json의 autoUpdate 설정
   ↓ (설정 안 됨)
3. 기본값 (설치 방법에 따라 다름)

1. ORBITRON_AUTO_UPDATE environment variable (highest priority)
   ↓ (not set)
2. autoUpdate setting in ~/.orbitron.json
   ↓ (not set)
3. Default value (depends on installation method)

강제 업데이트는 어떻게 되나요?

What About Forced Updates?

치명적인 보안 취약점이 발견되면 강제 업데이트가 필요할 수 있습니다.

If a critical security vulnerability is discovered, a forced update may be required.

강제 업데이트 동작

Forced Update Behavior

보안 패치가 포함된 버전을 실행하지 않으면 Orbitron이 시작되지 않습니다:

If you don't run a version with the security patch, Orbitron won't start:

$ orbitron

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
              ⚠️  Critical Security Update Required
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Current version: v0.1.10
Required version: v0.1.13

This update is required for security and stability.
Your work in progress has been automatically saved.

How to update:
  curl -fsSL https://orbitron.alphacode.ai/api/install.sh | bash

Installation guide:
  https://alphacode-ai.gitbook.io/orbitron/user-guide/installation

Exiting to prevent running a vulnerable version.

왜 강제로 종료하나요?

Why Force Exit?

• 보안 우선: 취약한 버전으로 계속 실행하는 것보다 안전합니다
• 명확한 안내: 어떻게 업데이트하는지 친절하게 알려줍니다

• Security First: Safer than continuing to run a vulnerable version
• Clear Guidance: Provides friendly instructions on how to update

업데이트 방법

How to Update

macOS / Linux:

macOS / Linux:

curl -fsSL https://orbitron.alphacode.ai/api/install.sh | bash

Windows (PowerShell):

Windows (PowerShell):

irm https://orbitron.alphacode.ai/api/install.ps1 | iex

자주 묻는 질문

Frequently Asked Questions

$ orbitron
orbitron> 코드 리뷰해줘
# (백그라운드 업데이트 중...)
AI: 네, 코드를 리뷰하겠습니다...
# (작업 계속 가능)

$ orbitron
orbitron> Review the code
# (Background update in progress...)
AI: Sure, I'll review the code...
# (Work continues)

# macOS / Linux - 특정 버전 설치
curl -fsSL https://orbitron.alphacode.ai/api/install.sh | VERSION=0.1.11 bash

# Windows - 특정 버전 설치
$env:VERSION="0.1.11"; irm https://orbitron.alphacode.ai/api/install.ps1 | iex

# 설치 후 버전 확인
orbitron --version
# v0.1.11

# macOS / Linux - Install specific version
curl -fsSL https://orbitron.alphacode.ai/api/install.sh | VERSION=0.1.11 bash

# Windows - Install specific version
$env:VERSION="0.1.11"; irm https://orbitron.alphacode.ai/api/install.ps1 | iex

# Check version after installation
orbitron --version
# v0.1.11

$ orbitron
orbitron> /update

✓ Checking for updates...
✓ Downloading update v0.1.13...
✓ Update v0.1.13 installed successfully! Restart to apply.

# 현재 버전 확인
$ orbitron --version
v0.1.13

# 이전 버전으로 롤백
$ cd ~/.local/bin
$ rm orbitron
$ ln -s ../share/orbitron/versions/0.1.12/orbitron orbitron

$ orbitron --version
v0.1.12  # 롤백 완료

# Check current version
$ orbitron --version
v0.1.13

# Rollback to previous version
$ cd ~/.local/bin
$ rm orbitron
$ ln -s ../share/orbitron/versions/0.1.11/orbitron orbitron

$ orbitron --version
v0.1.12  # Rollback complete

# macOS / Linux
curl -fsSL https://orbitron.alphacode.ai/api/install.sh | VERSION=0.1.12 bash

# macOS / Linux
curl -fsSL https://orbitron.alphacode.ai/api/install.sh | VERSION=0.1.12 bash

# Orbitron 실행 중에 /update 명령어 사용
orbitron> /update
✓ Checking for updates...
✓ Downloading update v0.1.13...
✓ Update installed! Restart to apply.

# Use /update command while running Orbitron
orbitron> /update
✓ Checking for updates...
✓ Downloading update v0.1.13...
✓ Update installed! Restart to apply.

정리

Summary

Orbitron의 자동 업데이트 시스템은 "신경 쓰지 않아도 되는" 경험을 제공합니다.

Orbitron's auto-update system provides a "worry-free" experience.

사용자가 얻는 것

What Users Get

• 시간 절약: 수동 업데이트 과정 불필요
• 항상 최신: 새 기능과 버그 수정을 자동으로 받음
• 작업 방해 없음: 백그라운드 다운로드
• 선택권 보장: 자동 업데이트 on/off 가능
• 안전: 체크섬 검증, 자동 롤백, 보안 패치 강제 적용

• Save Time: No manual update process needed
• Always Latest: Automatically receive new features and bug fixes
• No Disruption: Background downloads
• Choice Guaranteed: Can turn auto-update on/off
• Safe: Checksum verification, automatic rollback, forced security patches

권장 사용법

Recommended Usage

# 자동 업데이트 활성화 (권장)
orbitron config set autoUpdate true

# 그냥 평소처럼 사용하세요!
orbitron

# Enable auto-update (recommended)
orbitron config set autoUpdate true

# Just use it as usual!
orbitron

시작하기

Getting Started

아직 Orbitron을 설치하지 않으셨나요?

Haven't Installed Orbitron Yet?

# Unix (macOS, Linux)
curl -fsSL https://orbitron.alphacode.ai/api/install.sh | bash

# Windows (PowerShell)
irm https://orbitron.alphacode.ai/api/install.ps1 | iex

# Unix (macOS, Linux)
curl -fsSL https://orbitron.alphacode.ai/api/install.sh | bash

# Windows (PowerShell)
irm https://orbitron.alphacode.ai/api/install.ps1 | iex

설치 시 자동 업데이트 활성화를 선택할 수 있습니다!

You can choose to enable auto-update during installation!

이미 Orbitron을 사용 중이라면?

Already Using Orbitron?

# 1. 최신 버전으로 업데이트
curl -fsSL https://orbitron.alphacode.ai/api/install.sh | bash

# 2. 자동 업데이트 활성화
orbitron config set autoUpdate true

# 1. Update to latest version
curl -fsSL https://orbitron.alphacode.ai/api/install.sh | bash

# 2. Enable auto-update
orbitron config set autoUpdate true

도움이 필요하신가요?

Need Help?

• 📖 공식 문서
• 📖 Official Documentation
• 📚 설치 가이드
• 📚 Installation Guide
• 🔄 자동 업데이트 가이드
• 🔄 Auto-Update Guide
• 🔧 문제 해결 가이드
• 🔧 Troubleshooting Guide