Resterm: 터미널 속에서 만나는 강력한 API 클라이언트

Postman이나 Insomnia 같은 GUI 기반 API 테스트 도구는 많은 개발자에게 익숙하다. 하지만 터미널 환경에서 작업하는 개발자라면, 매번 프로그램을 전환하거나 마우스를 사용해야 하는 불편함을 느껴본 적이 있을 것이다.

Resterm은 이런 문제를 해결하기 위해 등장한 터미널 기반 REST 클라이언트이다.
HTTP뿐만 아니라 GraphQL과 gRPC까지 지원하며, .http 혹은 .rest 파일을 직접 읽어 명령행에서 API 요청을 수행할 수 있다.
Postman을 켜지 않아도, IDE를 띄우지 않아도, 오직 터미널 안에서 API 요청과 응답을 확인할 수 있는 것이 Resterm의 가장 큰 장점이다.

이 글에서는 Resterm의 주요 기능과 특징, 사용 방법, 그리고 개발자 워크플로우에서 어떤 혁신을 가져올 수 있는지를 살펴본다.

반응형

---

Resterm이란 무엇인가?

Resterm은 CLI(명령줄 인터페이스) 환경에서 작동하는 REST 클라이언트이다.
주요 목적은 “터미널을 벗어나지 않고 API 요청을 수행하고 결과를 확인할 수 있는 환경”을 제공하는 것이다.

• 지원 프로토콜: HTTP, GraphQL, gRPC
• 입력 형식: .http 또는 .rest 파일
• 기반 인터페이스: Vim 스타일 키바인딩을 채택한 모달 편집기

즉, Resterm은 단순한 CLI 요청 도구가 아니라, 개발자의 생산성을 극대화하는 통합형 API 테스트 환경이라고 할 수 있다.

---

Resterm의 주요 특징

1. HTTP, GraphQL, gRPC 지원

Resterm은 다양한 API 요청 형식을 지원한다.
기존 REST API뿐 아니라 @graphql, @grpc 지시어를 사용하면 해당 요청 형식에 맞게 자동으로 포맷팅하고 메타데이터를 처리할 수 있다.
이를 통해 하나의 터미널 환경에서 서로 다른 프로토콜을 동시에 다룰 수 있다.

2. Vim 키바인딩 기반 편집기

Resterm의 인터페이스는 Vim 키바인딩을 기반으로 설계되어 있다.
시각적 선택, 복사(yank), 삭제(cut), Shift+F 검색, i와 Esc를 통한 입력/보기 모드 전환 등이 가능하다.
이 덕분에 Vim 사용자라면 학습 곡선 없이 바로 사용할 수 있다.

3. 워크스페이스 탐색기 및 증분 검색

Resterm에는 워크스페이스 탐색 기능이 내장되어 있으며, .http나 .rest 파일만 필터링하여 탐색할 수 있다.
또한 증분 검색을 통해 원하는 파일로 빠르게 이동할 수 있어, 대규모 프로젝트에서도 효율적인 API 요청 관리가 가능하다.

4. 인라인 요청 실행

별도의 파일을 작성하지 않고도 URL만 입력한 뒤 Ctrl + Enter를 누르면 즉시 요청을 실행할 수 있다.
이 기능은 간단한 API 테스트나 응답 확인 시 매우 유용하다.

5. Curl 명령어 파싱

Resterm은 curl 명령어를 해석해 요청으로 변환할 수 있다.
기존에 사용하던 curl 명령을 그대로 Resterm으로 옮겨와 활용할 수 있어, CLI 사용자에게 친숙한 사용 경험을 제공한다.

---

응답 패널과 결과 분석

Resterm은 상태 인식형 응답 패널을 제공한다.
응답 화면 상단에는 현재 워크스페이스, 환경, 실행 중인 요청, 스크립트 및 테스트 결과가 표시된다.

응답 영역은 다음과 같이 구성된다.

• Pretty: 가독성 높은 포맷으로 응답 데이터를 표시
• Raw: 원본 응답 데이터 확인
• Headers: 응답 헤더 정보 확인
• History: 이전 요청 및 응답 이력 관리

또한 응답 패널을 세로 또는 가로로 분할하여 여러 요청의 결과를 동시에 비교할 수 있다.
pin 기능을 활용하면 특정 탭을 고정하여 Pretty / Raw / Headers 탭을 나란히 확인하거나, 통합 Diff 뷰로 응답 차이를 비교할 수도 있다.

---

인증 및 내장 헬퍼 기능

Resterm은 다양한 인증 방식을 지원한다.

• Basic
• Bearer Token
• API Key
• 사용자 정의 헤더

@auth 명령어를 사용하여 손쉽게 인증 정보를 설정할 수 있으며,
{{$timestamp}}, {{$uuid}} 등 내장 헬퍼 함수를 통해 요청 시점에 필요한 값을 자동 생성할 수 있다.

---

요청 전/후 스크립트 기능

Resterm은 JavaScript 기반의 스크립팅 기능을 제공한다.

• Pre-request Script: 요청 전 실행되어 요청 내용을 수정하거나 헤더를 추가
• Test Script: 응답 후 실행되어 검증(assert) 수행 및 결과를 에디터 내에서 바로 확인

예를 들어 다음과 같이 사용할 수 있다.

// Pre-request
req.headers['X-Request-Timestamp'] = Date.now();

// Test Script
assert(response.status === 200, "Status code should be 200");

이처럼 Postman의 스크립팅 기능을 CLI에서도 동일하게 활용할 수 있다는 점이 큰 장점이다.

---

세션 지속성과 보안

Resterm은 세션 정보를 자동으로 유지한다.

• Cookie Jar: 쿠키 저장 및 재사용
• 요청 히스토리: 이전 요청을 쉽게 복원 가능
• 환경 변수 유지: 재시작 후에도 환경 정보 보존

또한 @no-log 명령을 사용하면 민감한 응답 데이터를 기록에서 제외할 수 있어 보안적인 측면에서도 신뢰할 수 있다.

---

Resterm 사용 예시

다음은 .http 파일을 이용해 간단한 GET 요청을 수행하는 예시이다.

# sample.http
GET https://api.github.com/repos/unkn0wn-root/resterm
Authorization: Bearer {{$env.GITHUB_TOKEN}}

터미널에서 다음 명령을 실행하면 된다.

resterm run sample.http

또는 터미널에서 직접 인라인 요청을 입력해도 된다.

> https://api.github.com/repos/unkn0wn-root/resterm

Ctrl + Enter를 누르면 즉시 요청이 실행되고, 응답 패널에서 결과를 확인할 수 있다.

---

Resterm과 Postman 비교

항목	Resterm	Postman
실행 환경	CLI 기반	GUI 기반
프로토콜 지원	HTTP, GraphQL, gRPC	HTTP, GraphQL
스크립팅	JavaScript Pre/Post 요청 스크립트	지원
세션 유지	자동 (cookie jar, history)	지원
인터페이스	Vim 키바인딩	마우스 기반
빠른 요청 실행	Ctrl + Enter 인라인 실행	GUI 버튼 클릭

결국 Resterm은 마우스를 벗어나고 싶은 개발자, Vim 사용자, 터미널 중심 개발 환경을 선호하는 사용자에게 이상적인 선택이다.

---

728x90

Resterm은 단순한 터미널 도구를 넘어, 개발자가 API 요청을 테스트하고 관리하는 방식을 재정의한다.
Postman의 편리함과 Vim의 효율성을 결합하여, 오로지 키보드만으로 모든 API 워크플로우를 처리할 수 있게 한다.

앞으로 CLI 환경에서의 개발 자동화와 통합 테스트 수요가 늘어날수록,
Resterm 같은 도구는 점점 더 중요한 역할을 하게 될 것이다.

즉, Resterm은 터미널 중심 개발 문화 속에서 생산성과 집중력을 극대화하는 차세대 API 클라이언트라고 할 수 있다.

https://github.com/unkn0wn-root/resterm

GitHub - unkn0wn-root/resterm: Terminal client for .http/.rest files with HTTP, GraphQL and gRPC support, workflows, profiling a