stax – streamline your git workflow

브랜치 및 커밋 관리

stax commit 명령은 현재 변경 사항을 커밋하고 동일한 이름의 브랜치를 생성하여 원격 저장소에 푸시합니다. 사용자는 커밋 메시지를 필수로 입력하고, 선택적으로 브랜치 이름을 지정할 수 있습니다. 또한 -A, -a, -u 플래그를 통해 git add 동작을 커스터마이징할 수 있습니다.

풀 리퀘스트 생성 및 관리

stax pull-request(또는 pr) 명령은 풀 리퀘스트 생성 페이지를 엽니다. stax commit의 -p 플래그를 사용하면 커밋과 동시에 풀 리퀘스트 생성 페이지를 열 수 있으며, -d 플래그로 드래프트 모드의 PR을 생성할 수 있습니다. -n 플래그는 브라우저 자동 열기를 방지합니다.

브랜치 정리 및 동기화

stax delete-stale은 원격에서 삭제된 브랜치에 대응하는 로컬 브랜치를 삭제하여 저장소를 깨끗하게 유지합니다. stax pull은 메인 브랜치로 전환하고 변경 사항을 풀린 후, 사라진 원격 브랜치를 삭제하고 원래 브랜치로 돌아갑니다. 이 과정에서 -f 플래그는 강제 삭제를, -s 플래그는 삭제를 건너뛰게 합니다.

브랜치 트리 시각화 및 탐색

stax log는 브랜치 트리 구조를 트리 형태로 출력하여 현재 브랜치의 계층 관계를 보여줍니다. -a 플래그는 원격 브랜치도 표시하며, -d 플래그는 기본 브랜치를 변경하여 표시할 수 있습니다. stax move 명령은 이 트리 구조에서 위, 아래, 왼쪽, 오른쪽, 위쪽, 아래쪽 등으로 이동할 수 있게 해줍니다.

브랜치 재베이스 및 복구

stax rebase는 메인 브랜치를 기준으로 브랜치 트리를 재배치합니다. -c 플래그는 진행 중인 재베이스를 계속하고, -a 플래그는 진행 중인 재베이스를 포기합니다. -b 및 -m 플래그는 충돌 시 기준 또는 이동 변경 사항을 우선시합니다. stax get은 특정 브랜치와 그 하위 브랜치를 체크아웃하고, 선택적으로 재베이스 작업을 수행할 수 있습니다.

다운로드·설치 방법

Windows 사용자는 Chocolatey 패키지 관리자를 통해 stax를 설치할 수 있습니다. 먼저 Chocolatey가 설치되어 있어야 하며, 공식 가이드()를 따라 설치할 수 있습니다. Chocolatey가 준비되면 다음 PowerShell 명령을 실행하여 stax를 설치합니다:

choco install stax

설치 후, stax doctor 명령을 실행하여 개발 환경이 올바르게 구성되었는지 확인할 수 있습니다. 이 명령은 Git 사용자 이름, 이메일, 원격 저장소 설정 등을 점검합니다.

기본 사용법/명령어

stax의 전체 명령 목록은 다음 명령으로 확인할 수 있습니다:

stax help

주요 명령어 사용 예시는 다음과 같습니다:

• 커밋 및 브랜치 생성: stax commit "커밋 메시지"
• 선택적 브랜치 이름 지정: stax commit "메시지" 브랜치이름
• 현재 커밋 수정 및 강제 푸시: stax amend
• 삭제된 원격 브랜치에 대응하는 로컬 브랜치 삭제: stax delete-stale
• 메인 브랜치 동기화 및 로컬 브랜치 복구: stax pull
• 브랜치 트리 구조 보기: stax log
• 풀 리퀘스트 생성 페이지 열기: stax pull-request 또는 stax pr
• 도움말 보기: stax help
• 버전 정보 보기: stax extras version

전역 플래그로는 –help(–h)로 도움말을 보고, –quiet(-q)로 출력을 최소화하며, –verbose(-v)로 모든 출력을 강제할 수 있습니다. –accept-all과 –decline-all은 사용자 프롬프트를 자동으로 수락 또는 거절합니다.

이런 경우에 유용합니다

여러 개의 관련 기능을 작은 단위의 커밋으로 나누어 개발하고, 이를 스택형 PR으로 검토받고 싶은 개발자에게 유용합니다. stax는 브랜치 생성과 커밋을 자동화하여 각 기능을 독립적인 브랜치로 관리하고, 이를 순차적으로 PR로 올려 검토 프로세스를 효율적으로 진행할 수 있게 합니다. 특히 GitHub을 원격 저장소로 사용하는 팀에서 풀 리퀘스트 워크플로우를 표준화하고자 할 때 도움이 됩니다.

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

stax는 Dart 언어로 개발되었으며, Dart 실행 환경이 필요합니다. Windows에서는 Chocolatey를 통해 설치 시 필요한 의존성이 자동으로 처리됩니다. 대체 설치 방법으로는 저장소를 클론하고 Dart를 수동으로 설치한 후, 저장소의 path 폴더를 시스템 PATH 변수에 추가하는 방법이 있습니다.

최신 버전·업데이트

현재 버전은 0.11.10이며, 최신 소스 코드와 변경 사항은 공식 GitHub 저장소()에서 확인할 수 있습니다. 업데이트는 Chocolatey를 통해 choco upgrade stax 명령으로 수행할 수 있습니다.

제한 사항·확인 사항

stax pull-request 및 stax commit의 -p, -d 플래그는 GitHub 원격 저장소가 설정되어 있을 때만 작동합니다. 다른 Git 호스팅 서비스(GitLab, Bitbucket 등)를 사용할 경우 이 기능은 사용할 수 없습니다. 또한 stax doctor 명령은 Git 사용자 정보와 원격 저장소 설정을 점검하므로, 이러한 설정이 미리 구성되어 있어야 정상적으로 작동합니다.