# gail - AI 기반 GitHub 이슈 자동 라벨링 도구

> Clean Markdown view of GeekNews topic #21112. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=21112](https://news.hada.io/topic?id=21112)
- GeekNews Markdown: [https://news.hada.io/topic/21112.md](https://news.hada.io/topic/21112.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2025-05-26T10:17:02+09:00
- Updated: 2025-05-26T10:17:02+09:00
- Original source: [github.com/atgreen](https://github.com/atgreen/gail)
- Points: 5
- Comments: 1

## Summary

**OpenAI LLM**을 적용하여 **GitHub 이슈**를 프로젝트별로 자동 분류하며, 개발자가 직접 라벨을 추가하는 반복 작업을 대폭 줄입니다. 사용자는 **라벨 목록 파일**과 **모델**을 커맨드라인으로 자유롭게 지정할 수 있고, `.gail-labels` 파일만 추가하면 즉시 **추가 설정 없이 실행** 가능합니다. 초기에는 **libffi 오픈 이슈 정리**를 위해 개발하였으며, 간단한 설치 및 명령어로 다양한 프로젝트에 빠르게 적용할 수 있습니다.

## Topic Body

- OpenAI LLM을 활용하여 GitHub 프로젝트의 이슈를 분석하여 **자동으로 적절한 라벨을 부여**하는 도구   
- 사용자가 제공한 **라벨 목록 파일을 기반**으로 작동하며, 특정 저장소의 이슈들을 읽고 적합한 라벨을 선택  
- `gpt-4o-mini`를 기본 모델로 사용하며, 커맨드라인에서 모델과 라벨 파일, dry-run 여부를 **유연하게 설정 가능**  
- `.gail-labels` 파일을 프로젝트 루트에 추가하면 해당 파일을 자동으로 사용하며, **추가 설정 없이 간편하게 실행**   
- 원래는 [libffi](https://github.com/libffi/libffi)의 200개 이상 오픈 이슈 정리를 위해 개발되었으며, 기대 이상으로 잘 작동함  
- 의존성 설치는 [`ocicl`](https://github.com/ocicl/ocicl)를 사용  
  ```bash  
  $ ocicl install  
  $ make  
  ```  
- 사용법  
  ```bash  
  $ gail OWNER REPO [옵션]  
  ```  
  - 주요 옵션:  
    * `--labels <파일경로>`: 사용할 라벨 목록 파일 지정 (`.gail-labels` 기본값)  
    * `--model <모델명>`: 사용할 OpenAI 모델 지정 (`gpt-4o-mini` 기본값)  
    * `--dry-run`: 실제 라벨링 없이 결과만 시뮬레이션  
- `.gail-labels` 파일을 저장소 루트에 추가하면 자동으로 해당 라벨 파일을 인식하여 사용함  
  - libffi의 라벨 예제 : [https://github.com/libffi/libffi/blob/master/.gail-labels](https://github.com/libffi/libffi/blob/master/.gail-labels)

## Comments



### Comment 39267

- Author: minhoryang
- Created: 2025-05-26T15:29:51+09:00
- Points: 1

Common Lisp 프로젝트네요. 그래서 ocicl+make 조합이 되는거군요. Vibe AI에게 이걸 던져주고 그냥 typescript+deno로 만들어달라고하는게 더 유지보수가 편하겠어요.