developers · May 11, 2026
Quire CLI 소개: 터미널에서 바로 하는 프로젝트 관리
요약
Quire CLI는 터미널에서 Quire를 관리하기 위한 독립형 커맨드라인 도구입니다. npm 또는 Homebrew로 한 번만 설치하고, OAuth로 로그인한 뒤 파이프, 스크립트, cron으로 활용할 수 있는 구조화된 서브커맨드(quire project list, quire task create, quire mine)를 실행하세요. Quire MCP 서버는 Quire를 도구로 호출하는 Claude Code나 ChatGPT 같은 AI 에이전트를 위한 것으로, CLI와는 다른 범주입니다. 터미널에서 생활하며 속도, 스크립트 가능성, 예측 가능한 명령어를 원한다면 CLI를 선택하세요.
대부분의 Quire 사용자는 브라우저에서 작업합니다. 웹 앱은 시각적 계획 수립, 드래그 앤 드롭 하위 목록, 이해관계자 검토를 위한 최적의 환경입니다. 그러나 브라우저 탭을 열어서 업무 세 개를 완료 처리하는 것이 번거롭다고 느끼는 조용한 사용자 그룹이 있습니다. 개발자, 운영 담당자, 테크니컬 PM, 이미 터미널에서 생활하는 모든 사람들이 바로 그들입니다. Quire CLI는 이런 사람들을 위한 도구입니다.
AI 도구가 아닙니다. 자체 언어 모델도 없습니다. git, gh, aws처럼 이미 사용 중인 서비스에 대한 구조화된 커맨드라인 인터페이스입니다. 모든 작업이 파이프, 스크립트, 일정으로 활용할 수 있는 예측 가능한 명령어에 매핑됩니다. 한 번 로그인하면, 다음에 업무를 만들어야 할 시간이 왔을 때 올바른 Quire 탭을 찾느라 흐름을 끊을 필요가 없습니다.
아래에서 Quire CLI가 실제로 무엇인지, 설치 방법, 알아야 할 명령어, 그리고 첫 주 안에 설정 시간을 회수할 수 있는 다섯 가지 워크플로우 예제를 솔직하게 소개합니다.
Quire CLI란 무엇인가요?
Quire CLI(npm의 @quire-io/quire-cli, 설치 후에는 quire)는 OAuth를 통해 Quire API와 통신하는 단일 실행 파일입니다.
이런 도구입니다:
- 파이프와 스크립트로 활용할 수 있는 구조화된 서브커맨드를 갖춘 일반 커맨드라인 도구.
- OAuth 기반.
quire login을 한 번만 실행하면 되며, API 키 관리나 서비스 계정 설정이 필요 없습니다. - 크로스 플랫폼. macOS, Linux, Windows 등 Node.js 또는 단일 바이너리가 실행되는 모든 환경에서 사용 가능합니다.
- Quire API의 직접 인터페이스. 모든 CLI 명령어는 실제 API 엔드포인트에 매핑되므로, CLI가 수행하는 작업이 얇은 추상화 뒤에 숨겨지지 않습니다.
이런 도구가 아닙니다:
- AI 도구. Quire CLI는 자연어를 이해하지 못합니다. 명령어는 채팅 프롬프트가 아닌 구조화된 형태(
quire task create "Marketing_Q4" --name "Draft launch email")로 입력합니다. - 특정 AI 클라이언트에 종속된 도구. 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 vs Quire MCP 서버 vs 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 설정 가이드에서 Claude Code, ChatGPT, 또는 다른 호환 클라이언트에 MCP 서버를 연결하는 방법을 확인하세요. CLI와 MCP는 대안이 아닌 상호 보완적인 관계입니다.
사전 요구 사항
- 터미널에서 제어하려는 조직과 프로젝트가 하나 이상 있는 무료 또는 유료 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 페이지에서 단일 파일 바이너리를 다운로드하세요.
설치 후, 일회성 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 # 일회성 OAuth 설정
quire whoami # 로그인 확인
quire logout # 로컬 자격증명 삭제
quire project list # 프로젝트 목록 조회
quire task list "<project>" # 프로젝트의 업무 목록 조회
quire task tree <task-id> --depth full # 재귀적 서브트리 보기
quire task search "release notes" --mine # 업무 검색 (내 것만)
quire task create "<project>" --name "Ship CLI v1" --due 2026-06-30
quire task complete <task-id> # 업무 완료 처리
quire mine --all-orgs --json # 전체 조직의 내 업무 목록 조회
모든 명령어는 전체 옵션 확인을 위한 --help를 지원합니다. 대부분 머신이 읽을 수 있는 출력을 위한 --json도 지원하며, 이것이 아래 모든 워크플로우 예제의 기반이 됩니다.
| 리소스 | 주요 작업 |
|---|---|
| 업무 | 생성, 업데이트, 완료, 삭제, 이동, 대량 생성, 날짜 설정, 담당자 지정, 검색 |
| 하위 업무 & 하위 목록 | 생성, 목록 조회, 계층 구조 정리 |
| 프로젝트 | 목록 조회, 생성, 업데이트, 검색, 멤버 관리 |
| 댓글 | 추가, 업데이트, 삭제, 목록 조회 (첨부 파일 포함) |
| 태그 & 상태 | 생성, 업데이트, 적용, 목록 조회 |
| 문서 | 생성, 업데이트, 목록 조회, 내용 가져오기 |
| 인사이트 | 생성, 목록 조회, 맞춤형 필드 관리 |
| 채팅 | 생성, 목록 조회, 메시지 전송 |
| 조직 & 사용자 | 현재 사용자 조회, 조직 목록, 멤버 목록 |
모든 작업은 Quire REST API 엔드포인트와 1:1로 매핑됩니다.
워크플로우 예제
첫 주 안에 설치 시간을 회수할 수 있는 다섯 가지 소규모 패턴입니다.
데일리 스탠드업 다이제스트
quire mine --all-orgs --json \
| jq -r '.[] | select(.due == "2026-05-11") | "- [" + .name + "](" + .url + ") (" + .project + ")"'
오전 9시에 실행하고 마크다운을 Slack이나 일일 상태 문서에 붙여넣으세요. .zshrc에 alias를 추가하면 다음 날 아침에 한 단어로 실행할 수 있습니다:
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가 적합하지 않은 경우
몇 가지 솔직한 트레이드오프를 소개합니다.
- 터미널을 사용하지 않는 경우.
cd가 불편하게 느껴진다면, Quire 웹 앱이 맞는 선택입니다. CLI가 하는 모든 것은 웹 앱에서도 할 수 있습니다. CLI는 이미 셸에서 생활하는 사람에게 더 빠를 뿐입니다. - AI가 추론을 담당하길 원하는 경우. "멈춰 있는 프로젝트를 모두 찾아서 어떤 것을 에스컬레이션해야 할지 알려줘"라는 작업은 AI에 맞는 일입니다. Quire MCP 서버를 Claude Code, Codex CLI, ChatGPT, 또는 Claude Desktop에 연결하고 모델이 어떤 도구를 호출할지 결정하게 하세요. CLI는 데이터 파이프라인을 담당하고, MCP는 추론을 담당합니다.
- 완전히 관리되는 서버 사이드 통합이 필요한 경우. 웹훅으로 트리거되거나 운영하는 서비스에서 실행되는 워크플로우에는 Quire REST API가 개발자 노트북에 있는 OAuth 기반 CLI보다 더 안정적입니다.
- 네트워크가 OAuth 루프백 리다이렉트를 차단하는 경우. 일부 기업 VPN이 그렇습니다.
quire login이 리다이렉트를 기다리며 멈춘다면, 포기하기 전에 IT 팀에127.0.0.1콜백 허용을 요청해 보세요.
팁과 모범 사례
- 재사용하려는 모든 것에
--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 계정으로 전체 접근 가능, 신용카드 불필요.
