---
title: tuicr — 개발 환경 및 프로그래밍
date: 2026-10-18
time: 12:00
model: admin
category: programs
author_type: human
summary: 터미널에서 코드 검토(diff 읽기·주석·승인)를 수행하는 CLI 기반 코드 리뷰 도구.
tags: 프로그램, 개발 환경 및 프로그래밍, tuicr
---

터미널에서 코드 검토 작업을 수행하는 CLI 기반 코드 리뷰 도구입니다.

## 기본 정보

| 프로그램 이름 | tuicr (투익알) |
| --- | --- |
| 한 줄 소개 | 터미널에서 코드 검토 작업을 수행하는 CLI 기반 코드 리뷰 도구입니다. |
| 개발·유지 | tuicr contributors |
| 공식 홈페이지 | https://tuicr.dev/ |
| 공식 문서 | https://tuicr.dev/docs/ |
| 공식 다운로드 | https://tuicr.dev/downloads |
| 지원 운영체제 | Linux, macOS, Windows (Rust 1.75+) |
| 라이선스 | MIT |
| 안정 버전 | 1.6.0 (2026-10-10 출시) — 확인일 2026-10-18 |
| GitHub 저장소 | https://github.com/agavra/tuicr |
| 분류 | 개발 환경 및 프로그래밍 (태그: 코드 리뷰, CLI, 개발, pull request, diff) |

## 이 프로그램은 무엇인가?

tuicr는 코드 리뷰 과정을 터미널 안에서 수행할 수 있게 해 주는 CLI 도구입니다. GitHub·GitLab의 Pull Request/Merge Request를 불러와 diff를 읽고, 라인별 주석을 달고, 승인·요청 변경을 터미널에서 처리할 수 있습니다.

브라우저 없이 SSH 세션만으로 코드 리뷰를 완료할 수 있으며, 에디터(Vim·Neovim)와 연동해 diff를 바로 편집기에서 열 수도 있습니다. 키보드 중심 워크플로를 선호하는 개발자에게 적합합니다.

## 어떤 문제를 해결하는가?

- ('원격 서버 개발에서', '브라우저 없이 코드 리뷰를 해야 할 때', 'SSH 세션에서 tuicr로 PR을 열고 주석·승인을 처리할 수 있습니다.')
- ('리뷰 집중에서', '브라우저 알림에 방해받지 않고 리뷰하고 싶을 때', '터미널 단일 환경에서 리뷰에만 집중할 수 있습니다.')
- ('대량 리뷰에서', '여러 PR을 순차적으로 검토해야 할 때', '대기열(queue) 기능으로 여러 PR을 연속으로 리뷰할 수 있습니다.')
## 주요 기능

### PR/MR 불러오기

GitHub·GitLab에서 Pull Request를 터미널로 불러오기

- **활용 상황**: 리뷰 시작 시
- **얻는 결과**: 브라우저 없이 PR 목록·diff 접근
- **제한 사항**: 비공식 PR은 접근 권한 설정이 필요합니다.
### diff 탐색·주석

diff를 키보드로 탐색하고 라인별 주석 작성

- **활용 상황**: 코드 검토 중
- **얻는 결과**: 해당 라인에 리뷰 코멘트 추가
- **제한 사항**: 주석은 리뷰 제출 시 일괄 전송됩니다.
### 에디터 연동

선택한 파일을 Vim·Neovim·VS Code로 바로 열기

- **활용 상황**: 파일 전체 맥락 확인 필요 시
- **얻는 결과**: 터미널에서 리뷰+편집 원스톱
- **제한 사항**: 에디터 경로 설정이 필요합니다.
### 리뷰 제출

승인·요청 변경·코멘트를 일괄 제출

- **활용 상황**: 리뷰 완료 시
- **얻는 결과**: 단일 명령으로 리뷰 결과 전송
- **제한 사항**: 제출 후 수정은 별도 코멘트로 가능.
## 설치 및 실행

### Linux (바이너리)

공식 바이너리를 다운로드해 PATH에 추가합니다.

```
curl -fsSL https://tuicr.dev/install.sh | sh
tuicr --version
```

### cargo (소스)

Rust 1.75+ 환경에서 cargo로 설치합니다.

```
cargo install tuicr
tuicr --version
```

### macOS / Windows

홈브리우 또는 공식 설치 파일을 사용합니다.

```
brew install tuicr   # macOS
# Windows: tuicr.dev/downloads 에서 MSI
```

## 실제 사용 예제

### 인증 설정

GitHub·GitLab 토큰을 설정합니다. 토큰은 ~/.config/tuicr/config.toml에 저장됩니다.

```
$ tuicr auth login --provider github
# 토큰 입력: ghp_xxxxxxxxxxxx
# 저장 완료: ~/.config/tuicr/config.toml
```

### PR 목록·열기

열린 PR 목록을 보고 원하는 PR을 터미널에서 엽니다.

```
$ tuicr list --repo myorg/myapp

  #42  feat: add login rate limiting   (2 files, 3 comments)
  #43  fix: resolve race in session   (5 files, 0 comments)
  #44  chore: bump dependencies      (1 file, 0 comments)

$ tuicr open 43 --repo myorg/myapp
# diff 표시: 5 files changed, +82 -17
```

### 주석·승인

j/k로 이동하고 c로 주석, a로 승인합니다.

```
$ tuicr open 43 --repo myorg/myapp
# j/k: 이동 · c: 주석 · a: 승인 · r: 요청 변경 · q: 종료
```

## 장점과 한계

### 장점

- 브라우저 없이 SSH 세션에서 코드 리뷰 완료 가능
- Vim·Neovim·VS Code 연동으로 편집기 원스톱 워크플로
- GitHub·GitLab 양쪽 지원
- Rust 기반이라 빠르고 가벼움
### 사용 전에 고려할 점

- GitHub·GitLab API 토큰 설정이 선행되어야 합니다.
- GUI 리뷰 도구의 시각적 diff 비교(사이트드-바이-사이드)보다 탐색이 불편할 수 있습니다.
- large diff(수천 줄)는 터미널 탐색이 어려울 수 있습니다.
## 비슷한 프로그램과 비교

| 프로그램 | 특징 | 이런 경우에 적합 |
| --- | --- | --- |
| gh CLI | GitHub CLI — PR 관리·머지 등 전반적 기능 | PR 머지·이슈 관리 등 GitHub 종합操作 |
| tig | 터미널 Git 로그·블래이즈 뷰어 | Git 커밋 히스토리 탐색 중심 |
| GitHub Web UI | 브라우저 기반 코드 리뷰 | 시각적 사이드-바이-사이드 diff 선호 시 |

## 공식 자료 및 추가 학습

- [공식 홈페이지](https://tuicr.dev/) — https://tuicr.dev/
- [공식 문서 / 지식베이스](https://tuicr.dev/docs/) — https://tuicr.dev/docs/
- [공식 다운로드](https://tuicr.dev/downloads) — https://tuicr.dev/downloads
- [릴리스 노트](https://tuicr.dev/changelog) — https://tuicr.dev/changelog
- [소스 / 개발 자료](https://github.com/agavra/tuicr) — https://github.com/agavra/tuicr
버전·지원 환경 정보는 2026-10-18 기준으로 공식 사이트에서 확인한 값입니다. 설치 명령은 사용하는 배포판과 버전에 따라 달라질 수 있으므로 공식 설치 문서를 함께 확인하세요.

## 실제 실행 화면

아래는 사용 흐름을 이해하기 위해 만든 합성 예시 화면입니다(실제 실행 결과 아님). 화면은 합성 예시이며 실제 실행 결과가 아닙니다.

![tuicr PR 목록·diff 탐색·승인 예시: PR #43 race condition 수정 리뷰](https://games.cursorai.co.kr/assets/tuicr-demo.png)

실제 운영 중인 서버

---
원문(HTML): https://games.cursorai.co.kr/programs/apps/dev/tuicr.html