jirac

인터랙티브 TUI

전체 화면 터미널 인터페이스를 통해 마우스와 키보드로 이슈를 탐색하고 관리할 수 있습니다. 이슈 목록, 상세 보기, 댓글, 워크로그, 첨부 파일, 서브태스크 등을 터미널 밖으로 나가지 않고 처리할 수 있으며, 마우스 스크롤, 더블클릭, 클릭 동작을 지원하여 직관적인 작업이 가능합니다.

이슈 관리

이슈의 생성, 조회, 수정, 삭제, 타입 변경, 프로젝트 이동, 클론 등 완전한 이슈 라이프사이클을 명령줄에서 관리할 수 있습니다. 할당, 전환(Transition), 첨부 파일 업로드 및 다운로드, 링크 관리도 지원됩니다.

대량 작업 및 자동화

JQL 쿼리, 이슈 키 목록, JSON 매니페스트를 사용하여 여러 이슈에 동시에 댓글 추가, 상태 전환, 업데이트, 보관, 생성 작업을 수행할 수 있습니다. 대량 워크로그 등록도 지원됩니다.

JQL 빌더 및 검색

대화형 프롬프트를 통해 JQL 쿼리를 단계적으로 구성할 수 있으며, 생성된 쿼리를 바로 실행하여 결과를 확인할 수 있습니다. 저장된 JQL을 재사용하는 기능도 제공합니다.

워크로그 관리

이슈에 시간 기록을 추가, 목록 조회, 삭제할 수 있습니다. 특정 기간에 대한 워크로그를 등록할 때 주말 제외 옵션 등을 활용하여 백필(Backfill) 작업을 효율적으로 처리할 수 있습니다.

스프린트 및 보드 관리

애자일 스프린트의 생성, 시작, 업데이트, 완료, 삭제 및 보드 관련 작업을 명령줄에서 수행할 수 있습니다. 현재 스프린트 요약 보고서를 생성하는 기능도 포함되어 있습니다.

프로필 관리

여러 Jira 계정 또는 배포 환경의 인증 정보를 프로필로 저장하고, 간단한 명령으로 활성 프로필을 전환하여 빠르게 작업 환경을 변경할 수 있습니다.

다운로드·설치 방법

jirac은 여러 패키지 관리자를 통해 설치할 수 있습니다. 윈도우 사용자는 Scoop 또는 WinGet을 통해 설치할 수 있습니다.

• Scoop 사용 시: 먼저 Mulhamna의 스쿠프 버킷을 추가한 후 jirac 패키지를 설치합니다. 터미널에서 ‘scoop bucket add mulhamna https://github.com/mulhamna/scoop-bucket’ 명령을 실행하고, 그 다음 ‘scoop install mulhamna/jirac’ 명령으로 설치합니다.
• WinGet 사용 시: 터미널에서 ‘winget install mulhamna.jirac’ 명령을 실행하여 설치할 수 있습니다.

macOS나 Linux 사용자는 Homebrew를 통해 설치할 수 있으며, Rust 개발 환경이 있다면 ‘cargo install jira-commands’ 명령으로도 설치가 가능합니다.

기본 사용법

설치 후 가장 먼저 인증을 설정해야 합니다. 터미널에서 ‘jirac auth login’ 명령을 실행하여 대화형으로 Jira 서버 URL, 이메일, API 토큰 등의 인증 정보를 입력할 수 있습니다. 인증이 완료되면 다양한 명령으로 이슈를 관리할 수 있습니다.

• 이슈 목록 조회: ‘jirac issue list’ 명령으로 현재 사용자에게 할당된 이슈를 확인하거나, ‘-p 프로젝트키’ 옵션을 추가하여 특정 프로젝트의 이슈를 볼 수 있습니다.
• 이슈 상세 보기: ‘jirac issue view 이슈키’ 명령으로 특정 이슈의 상세 정보를 확인합니다. 브라우저에서 열려면 ‘–web’ 옵션을 추가합니다.
• TUI 실행: ‘jirac tui -p 프로젝트키’ 명령으로 전체 화면 인터페이스를 시작하여 마우스와 키보드로 이슈를 탐색하고 관리할 수 있습니다.

이런 경우에 유용합니다

jirac은 터미널 기반 워크플로우를 선호하는 개발자와 프로젝트 관리자에게 특히 유용합니다. 브라우저 전환이 필요한 이슈 작업을 명령줄에서 직접 처리하여 생산성을 높일 수 있으며, 대량 이슈 관리가 필요한 경우 스크립트와 연동하여 자동화된 작업을 수행할 수 있습니다. 또한 여러 Jira 서버를 동시에 관리하는 환경에서는 프로필 전환 기능을 통해 효율적인 인증 관리가 가능합니다.

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

jirac은 macOS, Linux, Windows 모든 주요 운영체제에서 지원됩니다. 네트워크 연결이 가능하고 Jira 서버 접근 권한이 있는 환경이면 어디서든 사용할 수 있습니다.

제한 사항·확인 사항

Jira 서버와의 통신을 위해 인증 자격 증명(API 토큰 등)이 필요합니다. 자체 인증서를 사용하는 Jira Data Center 환경에서는 CA 인증서 번들(ca_bundle) 설정이 필요할 수 있습니다. TUI 기능은 터미널의 지원 범위에 따라 일부 제한이 있을 수 있습니다.

FAQ

Q: jirac은 무료로 사용할 수 있나요?
A: jirac은 오픈 소스 라이선스(MIT + Apache-2.0)로 배포되어 무료로 사용할 수 있습니다.

Q: 윈도우에서 사용할 수 있나요?
A: 네, jirac은 윈도우를 지원하며, Scoop이나 WinGet을 통해 쉽게 설치할 수 있습니다.

Q: 인터넷 연결이 필수인가요?
A: 네, jirac은 Jira 서버와 통신하여 데이터를 주고받으므로 인터넷 연결이 필요합니다.

Q: 여러 Jira 계정을 관리할 수 있나요?
A: 네, 프로필 기능을 통해 여러 Jira 계정이나 배포 환경의 인증 정보를 저장하고 전환하여 사용할 수 있습니다.