Apple Foundation Models를 활용한 코드 생성용 TypeScript CLI 도구

█████╗ ██████╗ ██████╗ ██╗ ███████╗ ██████╗ ██████╗ ██████╗ ███████╗
██╔══██╗██╔══██╗██╔══██╗██║ ██╔════╝ ██╔════╝██╔═══██╗██╔══██╗██╔════╝
███████║██████╔╝██████╔╝██║ █████╗ ██║ ██║ ██║██║ ██║█████╗
...

Apple의 Foundation Models를 사용하는 코드 생성용 TypeScript CLI 도구

🍎 Apple Intelligence 통합

• 온디바이스 (on-device) Apple AI 모델 활용
  🎨 현대적인 터미널 UI
• ASCII art 브랜딩이 적용된 전문적인 CLI 인터페이스
  💬 대화 관리
• 지속적인 채팅 기록 및 세션 관리
  🌐 다국어 지원
• 25개 이상의 프로그래밍 언어에 대한 코드 생성
  📁 파일 작업
• 생성된 코드 저장, 편집 및 관리
  🎯 구문 강조 (Syntax Highlighting)
• highlight.js를 사용한 아름다운 코드 표시
  📋 클립보드 통합
• 생성된 코드를 macOS 클립보드로 복사
  🔧 전문적인 CLI
• 강력한 명령 구문 분석을 위해 Commander.js로 구축
  🛡️ 에러 처리
• 유연한 폴백 (fallback) 기능을 갖춘 포괄적인 에러 처리

macOS 15+ (Apple Intelligence 지원 필요)
Node.js 18+
Apple Silicon Mac (최적의 성능을 위해 권장)

# 저장소 클론 (Clone the repository)
git clone https://github.com/yourusername/apple-code-assistant.git
cd apple-code-assistant
...

# 현대적인 UI를 갖춘 대화형 모드 (Interactive mode)
apple-code -i
# 직접적인 코드 생성
...

apple-code -i

# TypeScript 코드 생성
apple-code -p "create a user authentication service" -l typescript
# Python 코드를 생성하고 파일로 저장
...

/help

• 사용 가능한 명령 표시
  /exit

• 애플리케이션 종료
  /clear

• 화면 지우기
  /history

• 대화 기록 표시
  /sessions

• 모든 세션 표시
  /models

• 사용 가능한 모델 표시
  /languages

• 지원되는 언어 표시
  /test

• Apple Intelligence 연결 테스트

-p, --prompt <prompt>

• 코드 생성 프롬프트 (prompt)
  -l, --language <language>

• 프로그래밍 언어 (language)
  -o, --output <file>

• 출력 파일 경로 (output file path)
  -i, --interactive

• 대화형 모드 (interactive mode)
  --save

• 파일로 저장
  --copy

• 클립보드로 복사
  --preview

• 터미널에서 미리보기 (preview in terminal)
  --context <context>

• 추가 컨텍스트 (additional context)
  --model <model>

• 사용할 Apple Foundation Model
  --temperature <number>

• 생성 온도 (0-2) (generation temperature)
  --max-tokens <number>

• 생성할 최대 토큰 수 (maximum tokens to generate)
  --theme <theme>

• 터미널 테마 (light/dark) (terminal theme)
  --verbose

• 상세 출력 (verbose output)
  --debug

• 디버그 모드 (debug mode)

TypeScript/JavaScript

• React, Node.js, Express, Vue, Angular
  Python
• Django, Flask, FastAPI, Pandas, NumPy
  Java
• Spring Boot, Android, Maven, Gradle
  C#/.NET
• ASP.NET, WPF, Entity Framework
  C/C++
• 시스템 프로그래밍 (system programming), 임베디드 개발 (embedded development)
  Go
• 웹 서비스 (web services), CLI 도구 (CLI tools), 마이크로서비스 (microservices)
  Rust
• 시스템 프로그래밍 (systems programming), 웹 어셈블리 (web assembly)
  Swift
• iOS, macOS 개발 (development), SwiftUI
  Kotlin
• Android 개발 (development), Spring
  PHP
• Laravel, Symfony, WordPress
  Ruby
• Rails, Sinatra, gems
  HTML/CSS
• 웹 개발 (web development), 반응형 디자인 (responsive design)
  SQL
• 데이터베이스 쿼리 (database queries), 저장 프로시저 (stored procedures)
  Shell/Bash
• 스크립팅 (scripting), 자동화 (automation)
  기타 등등... (And more...)

src/
├── api/ # Apple Intelligence 통합 (integration)
│ └── foundation-client.ts # 온디바이스 AI 클라이언트 (on-device AI client)
...

AppleFoundationClient

• 온디바이스 Apple Intelligence 통합을 처리합니다.
  SimpleTerminalUI
• 전문적인 브랜딩을 갖춘 현대적인 대화형 UI입니다.
  StreamingHandler
• 스트리밍 응답 (streaming responses)을 통한 실시간 코드 생성 기능을 제공합니다.
  ConversationManager
• 지속적인 채팅 기록 및 세션 관리 (session management)를 수행합니다.
  CLIParser
• Commander.js를 사용한 명령줄 인자 파싱 (command-line argument parsing)을 수행합니다.
  ConfigManager
• 파일 및 환경 변수로부터의 설정 관리 (configuration management)를 수행합니다.
  LanguageDetector
• 프롬프트로부터 프로그래밍 언어를 자동 감지합니다.
  SyntaxHighlighter
• highlight.js를 사용한 아름다운 코드 표시를 제공합니다.
  FileOperations
• 코드 저장 및 편집을 위한 파일 I/O 연산을 수행합니다.
  ClipboardManager
• macOS 클립보드 통합을 지원합니다.

.env 파일을 생성하거나 환경 변수를 설정하세요:

# 선택 사항: 사용할 Apple Foundation Model
APPLE_FOUNDATION_MODEL=apple-foundation-model
# 선택 사항: 기본 프로그래밍 언어
...

온디바이스 처리 (On-Device Processing)

• 모든 AI 처리는 Mac에서 로컬로 수행됩니다.

API 키 불필요 (No API Keys Required)

• Apple Intelligence를 직접 사용합니다.

데이터 전송 없음 (No Data Transmission)

• 코드와 프롬프트가 사용자의 기기에 그대로 유지됩니다.

안전한 설정 (Secure Configuration)

• 설정 파일은 사용자의 홈 디렉토리에 저장됩니다.

입력 검증 (Input Validation)

• 인젝션 공격 (Injection attacks) 및 잘못된 입력을 방지합니다.

• Node.js 18+

• TypeScript 5+

• npm 또는 yarn

• Swift (온디바이스 시뮬레이션용)

# 저장소 클론 (Clone the repository)
git clone https://github.com/yourusername/apple-code-assistant.git
cd apple-code-assistant
...

npm run build # TypeScript를 JavaScript로 빌드
npm run dev # 개발을 위해 ts-node로 실행
npm run start # 빌드된 JavaScript 실행
...

ASCII 아트 브랜딩 (ASCII Art Branding)

• figlet 및 gradient-string을 사용한 그라데이션 색상 적용

상태 정보 패널 (Status Information Panel)

• 시스템 인디케이터 및 버전 정보 포함

실시간 스트리밍 (Real-time Streaming)

• 청크 단위 출력 (Chunked output) 방식의 응답

구문 강조 (Syntax Highlighting)

• highlight.js를 사용한 생성된 코드의 구문 강조

대화 기록 (Conversation History)

• 세션 관리 및 컨텍스트 (Context) 포함

대화형 명령 (Interactive Commands)

• /help, /exit, /clear 등을 지원

직접 모드 (Direct Mode)

• 스크립팅 및 자동화용

파일 작업 (File Operations)

• 저장, 편집 및 생성 기능 포함

클립보드 통합 (Clipboard Integration)

• clipboardy를 사용한 macOS용 클립보드 연동

이 프로젝트는 MIT 라이선스(MIT License) 하에 라이선스가 부여됩니다 - 자세한 내용은 LICENSE 파일을 참조하세요.

영감을 받은 곳 (Inspired by)

• 업계 선도적인 CLI 애플리케이션들

기술 기반 (Powered by)

• 온디바이스 모델인 Apple Intelligence

제작 도구 (Built with)

• TypeScript, Node.js 및 현대적인 CLI 도구들

의존성 (Dependencies):

• Commander.js: CLI 파싱용
• Chalk: 터미널 스타일링용
• Figlet: ASCII 아트용
• Highlight.js: 구문 강조용
• Readline: 대화형 입력용

저장소 (Repository): https://github.com/yourusername/apple-code-assistant
이슈 (Issues): 버그 보고

• 온디바이스 (On-device) Apple Intelligence 통합
• 전문적인 브랜딩을 갖춘 현대적인 터미널 UI
• 실시간 스트리밍 응답 (Real-time streaming responses)
• 다국어 코드 생성
• 대화 기록 및 세션 관리
• 파일 작업 및 클립보드 통합
• 구문 강조 (Syntax highlighting) 및 에러 처리