Tina4 CLI

언어 자동 감지 및 프로젝트 초기화

프로젝트 디렉터리에서 pyproject.toml, composer.json, Gemfile, package.json 등을 스캔하여 프로젝트 언어를 자동으로 감지합니다. tina4 init 명령으로 새로운 Tina4 프로젝트를 scaffold할 수 있으며, 언어가 지정되지 않은 경우 사용 가능한 런타임을 기반으로 프롬프트를 표시합니다.

SCSS 컴파일 및 파일 변경 감지

내장된 Rust Sass 컴파일러(grass)를 사용하여 src/scss 디렉터리의 SCSS 파일을 src/public/css로 컴파일합니다. -w 플래그를 사용하면 파일 변경을 감지하여 자동으로 재컴파일합니다. 파일 변경 시 프레임워크에 reload 신호를 보내 브라우저에서 스타일시트를 전체 페이지 새로고침 없이 교체합니다.

개발 서버 및 핫-리로드

tina4 serve 명령으로 개발 서버를 시작하면 SCSS 컴파일, 파일 변경 감지(핫-리로드), 브라우저 자동 열기를 수행합니다. --port, --host, --dev, --production, --no-browser 옵션으로 동작을 세부 조정할 수 있습니다.

언어별 작업 위임

데이터베이스 마이그레이션(migrate), 테스트 실행(test), 라우트 목록(routes), 콘솔(console) 등의 명령은 감지된 프로젝트 언어에 따라 tina4python, tina4php, tina4ruby, tina4nodejs 등 언어별 CLI로 위임하여 실행됩니다.

AI 기술 설치 및 관리

tina4 skills 명령으로 Claude, Codex, Cursor 등 AI 코딩 도구용 Tina4 프레임워크 컨텍스트 및 스킬을 설치하거나 갱신할 수 있습니다. 대대화형 메뉴를 통해 선택하거나 tina4 skills claude 등과 같이 직접 지정할 수 있습니다.

Windows용 설치 방법

Windows에서는 다음과 같은 방법으로 Tina4 CLI를 설치할 수 있습니다.

• PowerShell을 사용한 직접 설치:

irm https://raw.githubusercontent.com/tina4stack/tina4/main/install.ps1 | iex

이 스크립트는 바이너리를 %LOCALAPPDATA%tina4에 설치하고 사용자 PATH에 자동으로 추가합니다. 설치 후 새 터미널을 열어 사용해야 합니다.

• 패키지 관리자를 통한 설치:
• Scoop (관리자 권한 불필요):

scoop bucket add tina4 https://github.com/tina4stack/scoop-bucket
scoop install tina4

• Chocolatey (관리자 권한 필요):

choco install tina4

• winget:

winget install Tina4Stack.Tina4

다른 플랫폼 설치 방법 (참고)

macOS/Linux에서는 curl 또는 wget을 사용한 설치 스크립트, Homebrew, apt, 또는 소스에서 Rust로 직접 빌드할 수 있습니다. 자세한 방법은 공식 README를 참조하십시오.

기본 사용법/명령어

설치 후 터미널 또는 PowerShell에서 tina4 명령을 사용할 수 있습니다. 주요 명령어는 다음과 같습니다.

• tina4 doctor: 설치된 언어, 패키지 관리자, Tina4 CLI 상태를 점검합니다.
• tina4 init [language] : 새로운 Tina4 프로젝트를 생성합니다. 언어가 지정되지 않은 경우 사용 가능한 런타임을 기반으로 프롬프트를 표시합니다.
• tina4 serve: 현재 디렉터리에서 개발 서버를 시작합니다. SCSS 컴파일, 파일 변경 감지, 브라우저 자동 열기를 수행합니다.
• tina4 scss [-w]: SCSS 파일을 컴파일합니다. -w 플래그로 변경 사항을 감시하여 자동 재컴파일할 수 있습니다.
• tina4 migrate [--create ]: 데이터베이스 마이그레이션을 실행하거나 새로운 마이그레이션 파일을 생성합니다.
• tina4 test: 프로젝트 테스트를 실행합니다. 감지된 언어에 해당하는 프레임워크 CLI에 위임됩니다.
• tina4 update 또는 tina4 upgrade: GitHub에서 최신 릴리스를 확인하여 Tina4 CLI 자체를 업데이트하고, 오래된 v2 CLI 바이너리를 제거합니다.

자세한 명령어 목록과 옵션은 tina4 --help 또는 공식 문서를 참조하십시오.

이런 경우에 유용합니다

Python, PHP, Ruby, Node.js 중 여러 언어를 사용하는 프로젝트에서 일관된 개발 워크플로우를 유지하고 싶을 때 유용합니다. 예를 들어, 백엔드 API를 PHP로 작성하고 프론트엔드 자산 관리를 위해 SCSS 컴파일 및 핫-리로드가 필요한 경우, Tina4 CLI는 언어 감지 및 위임을 통해 별도의 도구를 설치하거나 설정하지 않고도 통합된 명령어로 개발 서버를 실행하고 스타일시트를 자동으로 갱신할 수 있습니다. 또한, AI 코딩 도구 사용 시 tina4 skills 명령으로 관련 프레임워크 컨텍스트를 쉽게 설치하여 코드 생성 품질을 높일 수 있습니다.

지원 환경·시스템 요구사항

Tina4 CLI는 Windows x86_64 플랫폼용 사전 빌드 바이너리를 제공합니다. 공식 배포 채널(Chocolatey, Scoop, winget)을 통해 설치 시 Windows 10 이상에서 정상적으로 동작합니다. 소스에서 빌드하는 경우 Rust 툴체인이 필요하지만, 일반 사용자는 사전 빌드 바이너리를 사용하는 것이 권장됩니다.

최신 버전·업데이트

현재 버전은 3.8.86이며, 최신 안정 버전은 v3.13.136 (2026-09-09)입니다. tina4 update 또는 tina4 upgrade 명령을 실행하면 GitHub 릴리스에서 최신 버전을 확인하고 현재 설치된 바이너리를 교체합니다. 이 과정에서 기존 v2 Tina4 CLI 바이너리가 shadowing 문제를 일으킬 경우 자동으로 감지하여 제거합니다.

제한 사항·확인 사항

Tina4 CLI는 프로젝트 루트에서 언어 파일을 감지하여 동작하므로, 지원되는 매니페스트 파일(pyproject.toml, composer.json, Gemfile, package.json)이 없는 디렉터리에서는 일부 기능(언어 감지, 위임)이 제한될 수 있습니다. 이 경우 tina4 init로 프로젝트를 먼저 scaffold하거나, 수동으로 언어 런타임을 설치한 후 사용해야 합니다.