developers · May 11, 2026
Quire CLI 출시: 터미널에서 하는 프로젝트 관리
최종 업데이트: 2026년 9월 30일
Quire CLI는 터미널에서 Quire를 관리하는 독립형 명령줄 도구입니다. npm 또는 Homebrew로 한 번 설치하고 OAuth로 로그인한 뒤, 파이프·스크립트·cron에 연결할 수 있는 구조화된 하위 명령(quire project list, quire task create, quire mine)을 실행합니다. Claude Code나 ChatGPT 같은 AI 에이전트가 Quire를 도구로 호출하는 Quire MCP 서버와는 다른 범주입니다. 터미널에서 주로 일하며 속도, 스크립트 활용성, 예측 가능한 명령을 원한다면 CLI를 선택하십시오.
대부분의 Quire 사용자는 브라우저에서 일합니다. 시각적 계획, 드래그 앤 드롭 하위 목록, 이해관계자 검토에는 웹 앱이 가장 적합합니다. 하지만 이미 터미널에서 일하는 조용한 사용자층(개발자, 운영 담당자, 기술 PM 등)에게는 업무 세 개를 완료 처리하려고 브라우저 탭을 여는 것조차 번거롭습니다. Quire CLI는 바로 이런 분들을 위한 도구입니다.
Quire CLI는 AI 도구가 아니며, 자체 언어 모델을 탑재하지도 않습니다. git, gh, aws와 같은 종류의 도구입니다. 즉, 이미 사용 중인 서비스에 대한 구조화된 명령줄 인터페이스로, 모든 동작이 파이프·스크립트·예약 실행이 가능한 예측 가능한 명령에 대응합니다. 한 번 로그인해 두면, 다음에 업무를 만들 때 Quire 탭을 찾느라 흐름이 끊기지 않습니다.
아래에서 Quire CLI가 무엇인지, 설치 방법, 알아 둘 만한 명령어, 그리고 첫 주 안에 설정 시간을 되찾아 주는 다섯 가지 예시 워크플로를 있는 그대로 소개합니다.
Quire CLI란 무엇입니까?
Quire CLI(npm에서는 @quire-io/quire-cli, 설치 후에는 quire)는 OAuth를 통해 Quire API와 통신하는 단일 실행 파일입니다.
Quire CLI의 특징:
- 파이프와 스크립트에 활용할 수 있는 구조화된 하위 명령을 갖춘 일반 명령줄 도구입니다.
- OAuth 기반입니다.
quire login을 한 번만 실행하면 되고, API 키나 서비스 계정을 번거롭게 관리할 필요가 없습니다. - 크로스 플랫폼입니다. macOS, Linux, Windows 등 Node.js나 단일 바이너리가 실행되는 곳이라면 어디서든 동작합니다.
- Quire API에 대한 직접적인 인터페이스입니다. 모든 CLI 명령이 실제 API 엔드포인트에 대응하므로, CLI의 어떤 동작도 축소된 계층 뒤에 숨겨져 있지 않습니다.
Quire MCP와의 관계:
- 설계부터 구조화되어 있습니다. 명령이 구조화되어 있으므로(
quire task create "Marketing_Q4" --name "Draft launch email") 스크립트와 파이프는 매번 같은 결과를 얻습니다. - 터미널 앞의 사람을 위해 만들어졌습니다. AI 에이전트가 사용자를 대신해 Quire를 읽고 쓰게 하고 싶다면 Quire MCP 서버가 그 역할을 맡습니다. 접근 방식도, 대상도 다릅니다.
왜 Quire에 CLI가 필요합니까?
막연한 느낌이 아닌, 구체적인 이유 세 가지가 있습니다.
이유 1: 속도. Quire를 열고, 해당 프로젝트를 찾고, 해당 업무를 찾아 "완료"를 클릭하기까지는 순조로운 날에도 15~20초가 걸립니다. 이미 열려 있는 터미널에서 quire task complete <task-id>는 1초면 끝납니다. Quire를 많이 쓰는 사용자가 하루에 30번 남짓 하는 작업에 이를 곱하면 시간 차이는 계속 쌓입니다.
이유 2: 스크립트와 cron. CLI는 자동화의 기본 구성 요소입니다. 아침 셸 스크립트로 마감일 경과 업무를 Markdown 요약으로 모을 수 있습니다.
make weekly-status 타깃으로 모든 프로젝트에서 이번 주 완료 항목을 검색해 상태 업데이트를 작성할 수 있습니다. cron 작업으로 매주 금요일 오후 4시에 그 결과를 Slack에 게시할 수 있습니다. 이 모든 것은 채팅 창이나 웹 탭에서는 불가능합니다.
이유 3: 투명한 출력. 모든 CLI 명령은 무엇을 했는지 출력합니다. 방금 만든 업무 ID, API 응답, 실패 시 오류까지 그대로 보입니다. 숨겨진 도구 호출도, 결과를 확인할 길 없는 "제가 대신 만들어 드릴게요"도 없습니다. 공유 워크스페이스에 업무 40개가 들어가려는 순간, 이런 가시성이 유용한 도구와 골칫거리를 가릅니다.
Quire CLI, Quire MCP 서버, Quire REST API 중 무엇을 써야 합니까?
Quire는 세 가지 프로그래밍 방식의 접근 수단을 제공합니다. 작업에 맞는 것을 사용하십시오.
| 접근 수단 | 적합한 용도 | 호출 주체 |
|---|---|---|
| Quire CLI | 터미널 사용자, 셸 스크립트, 즉석 명령, cron 작업 | 직접 입력하는 사람 또는 실행 중인 셸 스크립트 |
| Quire MCP 서버 | Quire를 읽고 써야 하는 AI 에이전트 | Claude Code, Codex CLI, ChatGPT Connectors, Claude Desktop, Cursor, Perplexity 및 기타 모든 MCP 클라이언트 |
| Quire REST API | 서버 측 연동, 웹훅, 맞춤 앱 | 백엔드 서비스, n8n 또는 Zapier 플로, 웹훅 핸들러 |
MCP 서버와 CLI는 모두 OAuth로 인증합니다. REST API는 액세스 토큰을 사용합니다. 세 가지 모두 같은 데이터를 다루고 같은 권한을 따르므로, 어느 쪽에서 만든 업무든 나머지에 즉시 표시됩니다.
AI 쪽이 필요하다면 Quire MCP 설정 가이드에서 MCP 서버를 Claude Code, ChatGPT 또는 기타 호환 클라이언트에 연결하는 과정을 안내합니다. CLI와 MCP는 서로를 대체하는 것이 아니라 보완하는 관계입니다.
MCP 지원 측면에서 Quire가 다른 도구와 어떻게 비교되는지 궁금하다면 전체 비교를 다룬 2026년 MCP를 지원하는 프로젝트 관리 도구를 참고하십시오.
Quire CLI를 설치하기 전에 무엇이 필요합니까?
- 터미널에서 다룰 조직과 프로젝트가 하나 이상 있는 무료 또는 유료 Quire 계정.
- 터미널: macOS Terminal, iTerm2, Windows Terminal 또는 모든 Linux 셸.
- 다음 중 하나: Node.js 18 이상(npm 설치용), Homebrew(macOS 또는 Linux), 또는 GitHub Releases에서 단일 파일 바이너리를 내려받을 수 있는 환경.
localhost에서 OAuth 콜백을 받을 수 있는 환경. 대부분의 네트워크는 이를 허용하지만, 일부 기업 VPN은 차단합니다.quire login이 리디렉션을 기다리다 시간 초과되면 IT 부서에 루프백 리디렉션 허용을 요청하십시오.
Quire CLI는 어떻게 설치합니까?
Quire CLI는 단일 명령줄 바이너리로 제공됩니다. 평소 CLI를 관리하는 방식에 맞는 설치 방법을 고르십시오. 모든 옵션은 GitHub README에 나와 있습니다.
npm(대부분의 사용자):
npm i -g @quire-io/quire-cli
Homebrew(macOS 또는 Linux):
brew install quire-io/quire/quire
설치 없이 사용해 보기:
npx @quire-io/quire-cli --help
또는 GitHub Releases 페이지에서 단일 파일 바이너리를 내려받으십시오.
설치가 끝나면 최초 1회 OAuth 로그인을 실행합니다. 브라우저 탭이 열리면 Quire에 로그인해 워크스페이스 접근을 승인하고, CLI는 토큰을 ~/.config/quire/credentials.json(사용 가능한 경우 OS 키체인)에 저장합니다:
quire login
quire whoami
quire whoami가 계정 정보를 출력하면 연결된 것입니다. 실제 명령 몇 가지를 실행해 보십시오:
quire project list
quire task list "Marketing_Q4"
quire mine --all-orgs --json
Quire CLI로 무엇을 할 수 있습니까?
전체 하위 명령은 GitHub README에 정리되어 있지만, 첫날 알아 둘 명령은 한 화면에 다 들어갑니다.
quire login # one-time OAuth setup
quire whoami # confirm you are signed in
quire logout # remove local credentials
quire project list # list your projects
quire task list "<project>" # list tasks in a project
quire task tree <task-id> --depth full # recursive subtree view
quire task search "release notes" --mine # search tasks (yours only)
quire task create "<project>" --name "Ship CLI v1" --due 2026-06-30
quire task complete <task-id> # mark a task done
quire mine --all-orgs --json # list your tasks across orgs
모든 명령은 전체 옵션을 보여 주는 --help를 지원합니다. 대부분은 기계가 읽을 수 있는 출력을 위한 --json도 지원하며, 이것이 아래 모든 예시 워크플로의 기반입니다.
| 리소스 | 주요 동작 |
|---|---|
| 업무 | 생성, 수정, 완료, 삭제, 이동, 일괄 생성, 날짜 설정, 담당자 지정, 검색 |
| 하위 업무 및 하위 목록 | 생성, 목록 조회, 계층 정리 |
| 프로젝트 | 목록 조회, 생성, 수정, 검색, 멤버 관리 |
| 댓글 | 추가, 수정, 삭제, 목록 조회(첨부 파일 포함) |
| 태그 및 상태 | 생성, 수정, 적용, 목록 조회 |
| 문서 | 생성, 수정, 목록 조회, 내용 가져오기 |
| 인사이트 | 생성, 목록 조회, 맞춤형 필드 관리 |
| 채팅 | 생성, 목록 조회, 메시지 게시 |
| 조직 및 사용자 | 현재 사용자 조회, 조직 목록, 멤버 목록 |
모든 동작은 Quire REST API 엔드포인트와 1:1로 대응합니다.
Quire CLI 워크플로 예시에는 어떤 것이 있습니까?
첫 주 안에 설치 시간을 되찾아 주는 다섯 가지 간단한 패턴입니다.
데일리 스탠드업 요약
quire mine --all-orgs --json \
| jq -r '.[] | select(.due == "2026-05-11") | "- [" + .name + "](" + .url + ") (" + .project + ")"'
오전 9시에 실행해 Markdown 결과를 Slack이나 일일 상태 문서에 붙여 넣으십시오. .zshrc에 별칭을 추가하면 다음 날 아침부터는 한 단어로 실행됩니다:
alias standup='quire mine --all-orgs --json | jq -r "..."'
회의록에서 업무 일괄 생성
grep "^TODO:" ./meetings/2026-05-04-sync.md \
| sed 's/^TODO: //' \
| while read task; do
quire task create "Marketing_Q4" \
--name "$task" \
--tag "from-monday-sync" \
--due 2026-05-08
done
월요일마다 12분씩 걸리던 잡무가 셸 루프 하나로 줄어듭니다. Makefile에 넣어 두면 문법을 기억하지 않아도 매주 월요일 같은 타깃이 그대로 동작합니다.
Cron 작업: 금요일 마감일 경과 요약
0 17 * * 5 cd ~/work && /usr/local/bin/quire task search "overdue" --mine --json > friday.json
후속 스크립트와 짝지어 JSON을 Slack 웹훅으로 게시하거나, Notion 페이지를 생성하거나, 그냥 이메일로 받아 보십시오. 데이터 전달은 CLI가 처리하고, 끝에 무엇을 연결할지는 자유입니다.
콘텐츠 캘린더 CSV를 업무로 변환
tail -n +2 ./calendar/2026-Q2.csv \
| while IFS=, read -r publish_date channel title; do
quire task create "Content_Pipeline" \
--name "$title" \
--due "$publish_date" \
--tag "$channel"
done
파이프라인 하나로 CSV가 업무가 됩니다. 각 행에 출처 식별자 태그도 붙여 두면, 실행이 잘못되더라도 정리할 수 있어 멱등성을 확보할 수 있습니다.
파일의 ID로 업무 완료 처리
cat finished_today.txt | xargs -n 1 quire task complete
여기서 finished_today.txt는 한 줄에 하나씩 업무 ID를 적은 목록입니다. 금요일 오후 5시, 한꺼번에 마무리할 일이 여덟 개나 있는데 브라우저에서 하나씩 클릭하는 게 고역처럼 느껴질 때 유용합니다.
어떤 작업에 어떤 Quire 접근 수단이 맞습니까?
CLI는 Quire에 들어가는 네 가지 방법 중 하나이며, 나머지 세 가지도 각자 맡은 역할이 있습니다:
- 터미널을 쓰지 않는다면 웹 앱. CLI로 하는 모든 일은 웹 앱에서도 할 수 있습니다. CLI는 이미 셸에서 일하는 사람에게 더 빠를 뿐입니다.
- AI에게 추론을 맡기고 싶다면 Quire MCP. "정체된 프로젝트를 모두 찾아 어떤 것을 에스컬레이션할지 알려 줘" 같은 작업은 AI에 적합합니다. Quire MCP 서버를 Claude Code, Codex CLI, ChatGPT 또는 Claude Desktop에 연결하고 어떤 도구를 호출할지 모델이 판단하게 하십시오. CLI는 데이터 전달을, MCP는 추론을 담당합니다.
- 서버 측 연동에는 REST API. 웹훅으로 실행되거나 직접 운영하는 서비스에서 돌아가는 워크플로에는 무인 실행을 위해 만들어진 Quire REST API가 적합합니다.
설정 관련 참고 사항: 일부 기업 VPN은 OAuth 루프백 리디렉션을 차단합니다. quire login이 리디렉션을 기다리며 멈춰 있다면 IT 부서에 127.0.0.1 콜백 허용을 요청하십시오.
Quire CLI 활용 팁과 모범 사례는 무엇입니까?
- 재사용할 결과에는
--json과jq를 사용하십시오. 일반 텍스트 출력은 읽기에 좋고, JSON은 그 밖의 모든 용도에 좋습니다. 대부분의 CLI 명령이--json을 지원합니다. - 프로젝트 이름은 정확히 따옴표로 감싸십시오. "Marketing_Q4"는 명확하지만, "마케팅 그거"는 CLI가 아는 프로젝트 이름이 아닙니다. 프로젝트 이름은 대소문자를 구분합니다.
- 일괄 생성한 업무에는 태그를 붙이십시오.
--tag from-cli(또는--tag bulk-import-2026-05-11)를 추가해 두면 스크립트 실행이 잘못되었을 때 찾아서 정리하기가 아주 쉬워집니다. - 새 머신 설정 스크립트에 OAuth 로그인을 넣으십시오. 새로 설치한 뒤
quire login && quire whoami한 줄이면 새 노트북도 30초 만에 바로 쓸 수 있는 상태가 됩니다. quire <command> --help를 읽으십시오. 어떤 블로그 글보다 짧고 정확합니다. 모든 하위 명령의 모든 옵션이 그곳에 있습니다.- CLI와 MCP 서버를 함께 사용하십시오. 결정론적인 절반(생성, 완료, 목록 조회, 검색)은 CLI로, 모호한 절반(분류, 요약, 계획)은 MCP에 연결된 AI 클라이언트로 처리하십시오. 같은 데이터, 서로 보완하는 두 가지 접근 수단입니다.
핵심 정리
2026년의 흥미로운 변화는 AI 클라이언트가 프로젝트를 관리할 수 있게 되었다는 점이 아닙니다. 프로젝트 관리를 가장 많이 하는 사람들에게는 이미 신뢰하는 도구, 바로 터미널이 있었다는 점입니다. Quire CLI는 그들에게 워크스페이스로 들어가는 일급 진입점을 제공하며, 원하지 않는 한 그 경로에 AI는 끼어들지 않습니다.
터미널에서 일한다면 이번 주에 설치해 보십시오. 위 예시 워크플로 중 하나를 아침이나 금요일 루틴에 연결하십시오. 설정은 5분이면 끝납니다. 그 효과는 Quire를 사용하는 내내 계속 쌓입니다.
추론이 핵심인 작업에는 여전히 MCP 서버가 적합합니다. 둘은 경쟁 관계가 아니라, 같은 워크스페이스를 위한 상호 보완적인 접근 수단입니다.
자주 묻는 질문
Quire CLI란 무엇입니까?
Quire CLI는 Quire 전용 독립형 명령줄 도구입니다. npm, Homebrew 또는 바이너리로 설치하고 quire login을 실행하면, 어떤 터미널에서든 업무, 프로젝트, 문서를 관리할 수 있습니다.
Quire CLI와 Quire MCP 서버는 같은 것입니까?
아닙니다. Quire CLI는 명령을 직접 입력하는 사람을 위한 도구입니다. Quire MCP 서버는 Quire를 도구로 호출하는 AI 에이전트를 위한 것입니다. 데이터는 같고 대상만 다릅니다.
Quire CLI를 사용하려면 개발자여야 합니까?
아닙니다. 터미널을 열고 명령 두 개를 실행할 수 있다면 누구나 사용할 수 있습니다.
Quire CLI로 무엇을 할 수 있습니까?
업무 목록 조회와 검색, 일괄 생성과 완료, 하위 업무 정리, 프로젝트와 멤버 관리, 댓글 작성, 문서 생성이 가능합니다. Quire의 모든 객체에 접근할 수 있습니다.
언제 MCP 서버를 대신 사용해야 합니까?
추론이 필요한 작업일 때입니다. 분류, 요약, 비정형 메모를 업무로 바꾸는 일 등이 그렇습니다. Quire CLI는 결정론적인 절반을 담당합니다.
Quire CLI는 cron 작업에서도 동작합니까?
네. --json 출력을 사용하고, cron으로 예약하고, 결과를 원하는 곳에 게시하십시오.
무료 요금제가 있습니까?
네. Quire의 Free 플랜은 유료 플랜과 동일한 CLI 접근 권한을 제공합니다.
터미널에서 Quire 워크스페이스를 운영할 준비가 되셨습니까?
npm, Homebrew 또는 GitHub Releases에서 Quire CLI를 설치하십시오. 무료 Quire 계정으로 모든 기능을 이용할 수 있으며, 신용카드는 필요 없습니다.
