CmdQ 사용 설명서

화면 구성

창은 위에서부터 헤더, 프로젝트 탭, 추가바, 두 개의 큐 순서입니다.

헤더의 사용량

• 막대 두 개가 5시간 윈도우와 주간 한도 사용률이고, 링은 5시간 사용률입니다.
• 옆에 다음 리셋까지 남은 시간이 흐릅니다. 주간 한도에 걸려 있으면 주간 한도 · 재개까지로 바뀝니다.
• 값을 가져오지 못하면 읽지 못함, 그 계정에 없는 한도면 해당 없음이 뜹니다.
• 사용량은 statusline 연결을 했으면 그 값을 먼저 읽고, 아니면 /usage로 조회합니다. 조회 주기는 설정의 사용량 조회 주기입니다.

프로젝트 탭과 전체보기

• + 폴더(⌘O)로 프로젝트 폴더를 골라 탭을 엽니다. 탭은 그 경로의 항목만 보여 줍니다.
• 탭은 끌어서 순서를 바꾸고, 가운데 버튼으로 누르면 닫힙니다. 탭을 닫아도 그 경로의 항목은 지워지지 않고 자동 큐에서 계속 실행됩니다.
• 전체보기(⇧⌘A)를 켜면 열어 둔 탭의 항목을 경로별로 묶어 봅니다. 이때는 카드를 끌 수 없습니다.
• 탭을 바꾸면 추가바의 대상은 경로로, 넣을 곳은 To Do로 돌아갑니다.

추가바와 두 큐

추가바에서 명령을 적어 등록합니다(작업 등록). 그 아래 자동 큐와 To Do 두 목록이 나란히 있습니다(자동 큐와 To Do).

작업 번호

카드의 #12 같은 번호는 항목마다 붙는 고유 번호입니다. 순번과 달리 바뀌지 않아서 알림과 백그라운드 터미널 목록도 이 번호로 항목을 가리킵니다.

메뉴 막대 아이콘

아이콘을 누르면 구독 플랜, 사용률 바, 리셋까지 남은 시간, 조회 주기와 마지막 갱신 시각, 자동 큐 · 대기 N · 실행 중 N · 대화형 N 요약이 보입니다. 메뉴는 다음과 같습니다.

창을 닫아도 앱은 메뉴 막대에 남아 자동 큐를 계속 실행합니다. 완전히 끄려면 종료를 누르십시오.

앱은 켜고 20초쯤 뒤, 그다음에는 6시간마다 새 버전을 확인합니다. 새 버전이 있으면 설치할지 묻고, 설치 후 다시 시작을 누를 때만 내려받아 설치한 뒤 앱을 다시 시작합니다. 실행 중인 자동 큐 작업이나 열린 대화형 터미널이 있으면 다시 시작할 때 중지된다고 함께 알려 줍니다. 나중에를 고른 버전은 앱을 다시 켤 때까지 다시 묻지 않으며, 그사이에는 업데이트 확인…으로 직접 설치할 수 있습니다.

아이콘에 붙는 점

• 오른쪽 위 빨간 점: 확인하지 않은 알림이 있습니다. 메인 창을 보면 사라집니다.
• 오른쪽 아래 노란 점: 리셋을 기다리는 항목이 있습니다. 초록 점보다 먼저 이 자리를 씁니다.
• 오른쪽 아래 초록 점: 실행 중인 항목이나 대화형 터미널이 있습니다.

작업 등록

1. + 폴더로 탭을 엽니다. 추가바의 경로 칸이 그 폴더로 채워집니다.
2. 명령 입력창에 claude에게 시킬 일을 적습니다.
3. 키로 넣을 곳을 고릅니다.

추가 버튼은 추가바의 자동 큐/To Do 토글에서 고른 쪽에 넣습니다. 키로 넣을 때는 토글과 상관없이 위 표대로 들어갑니다. ⌥가 섞인 Enter는 제출하지 않습니다.

스킬 자동완성

입력창에 /로 시작하는 단어를 치면 사용자·프로젝트·플러그인 스킬 목록이 뜹니다.

• ↑ ↓로 고르고 Tab으로 넣습니다. Esc는 목록만 닫습니다.
• 목록이 떠 있을 때 Enter를 누르면 스킬은 들어가지 않고 적어 둔 명령이 그대로 등록됩니다.

이미지와 경로 넣기

• 이미지를 붙여 넣으면 입력창에 [IMAGE]로 표시되고 실행할 때 함께 넘어갑니다. 커서 바로 앞의 [IMAGE]는 백스페이스 한 번에 지워집니다.
• @를 치면 파일·폴더 경로 목록이 뜹니다. 경로 대상이면 지금 탭, 세션 대상이면 그 세션의 폴더를 기준으로 찾습니다. 목록이 열려 있으면 Enter도 Tab처럼 확정만 합니다.
• #을 치면 첨부를 골라 넣습니다(첨부).

실행 대상

추가바 왼쪽 버튼으로 명령을 어디서 돌릴지 정합니다.

세션 고르기

• 세션을 누르면 그 경로의 세션 목록이 뜹니다. 각 행에 컨텍스트 사용률이 보이고, 대화형으로 연 세션에는 대화형 배지가 붙습니다.
• 🕐 히스토리는 고른 세션에서 했던 질문 목록을 보여 줍니다.
• ▶ 터미널은 고른 세션의 대화형 터미널을 엽니다. 그 세션을 자동 큐가 실행 중이면 넘길지 묻습니다(대화형 터미널).

등록한 뒤 대상 바꾸기

카드의 대상 칩 옆 버튼으로 바꿉니다. 경로 항목은 세션 목록에서 하나를 고르고, 세션 항목은 📁 경로 명령으로 전환을 누릅니다. 실행 중이거나 완료된 항목, 하위를 거느린 체인 부모에는 이 버튼이 없습니다.

같은 세션이 바쁠 때

세션 대상 명령은 같은 세션이 작업 중이면 시작하지 않고 기다립니다. 앱 안의 대화형 터미널이든 큐의 다른 항목이든 앱 밖 터미널이든 마찬가지입니다. 이때 대기 중 토스트가 누가 쓰고 있는지 알려 줍니다. 경로 대상은 매번 새 세션이라 이런 대기가 없습니다.

자동 큐와 To Do

두 큐 사이는 언제든 옮깁니다. To Do 카드의 ▶는 자동 큐로 승격이고, 자동 큐 카드의 ▽는 To Do로 이동입니다. 승격해도 바로 실행되지는 않고 자동 큐 맨 뒤에 붙습니다.

몇 개가 함께 도나

• 같은 경로의 다음 항목은 앞 항목이 끝나야 시작합니다.
• 경로가 다르면 함께 돕니다. 전체 상한은 설정의 자동 큐 동시 실행(기본 3)이고, 자동 큐는 경로마다 한 건씩 돌리므로 이 값이 곧 동시에 진행되는 경로 수입니다.
• 카드의 ▶ 지금 실행(수동)은 순서를 건너뛰어 바로 돌립니다. 수동 실행은 자동 큐 상한에 세지 않지만, 한 경로의 자동·수동 합계는 같은 경로 동시 실행(기본 2)을 넘지 못합니다.
• 같은 경로에서 두 작업이 같은 파일을 고치면 한쪽 변경이 덮어써질 수 있습니다. 파일을 건드리는 작업이 많으면 같은 경로 동시 실행을 1로 두십시오.

순서 바꾸기

대기와 리셋 대기 카드는 위아래로 끌어 순서를 바꿉니다. 실행 중이거나 끝난 카드는 제자리에 있습니다. 오른쪽으로 끌면 체인이 됩니다(체인).

상태와 배지

실행 중인 항목은 claude가 출력을 내는 동안 계속 실행됩니다. 출력 없이 30분이 지나면 멈춘 것으로 보고 중단해 실패로 바꾸며, 실패 사유는 "출력 없이 30분이 지나 중단됨"입니다. 출력이 계속 나와도 최대 실행 시간 6시간을 넘으면 "최대 실행 시간 6시간을 넘겨 중단됨"으로 중단합니다. 어느 쪽이든 큐는 다음 항목으로 넘어갑니다. 두 값은 설정 화면에서 바꿀 수 없습니다.

체인

체인은 한 작업이 끝나면 다음 작업이 같은 세션을 이어받아 실행되게 묶는 기능입니다. 부모 아래에 하위 명령을 달아 두면 부모가 완료된 뒤 하위가 부모 세션에 --resume으로 붙어 차례로 돕니다. 하위는 부모가 한 일을 대화 맥락으로 기억하므로 "방금 바꾼 부분" 같은 지시가 통합니다.

만드는 법

1. 탭을 하나 고릅니다. 전체보기가 켜져 있으면 끌기가 잠깁니다.
2. 하위로 넣을 카드를 잡고 부모 카드 바로 아래로 옮기면서 오른쪽으로 끕니다. 오른쪽으로 32px쯤 넘어가면 자리 표시가 들여쓰기로 바뀝니다.
3. 놓으면 바로 위 카드의 하위가 됩니다. 하위 카드는 들여 쓰여 보이고, 부모 카드의 ▾/▸로 접고 펼칩니다.

하위 카드를 오른쪽으로 끌지 않고 다른 자리에 놓으면 체인에서 빠진 독립 항목이 됩니다. 부모를 끌면 하위가 함께 따라옵니다.

실행 순서

• 하위는 부모가 완료여야 시작합니다. 부모가 이미 완료된 상태에서 하위를 달면 다음 큐 확인 때 바로 차례가 옵니다.
• 하위가 여럿이면 위에서부터 하나씩 돕니다. 앞 하위가 완료되어야 다음 하위가 시작합니다.
• 부모를 ▶ 지금 실행(수동)으로 돌려도 완료 뒤 하위는 자동 큐에서 이어 실행됩니다.
• 하위가 이어받을 세션을 대화형 터미널이 쥐고 있으면 하위는 대기 중으로 기다립니다. 터미널을 종료하면 이어서 시작합니다. 백그라운드로 계속으로 닫은 터미널도 세션을 쥐고 있는 것으로 봅니다.
• 부모가 한도에 걸려 리셋 대기가 되면 하위도 기다렸다가, 부모가 재개해 완료되면 이어집니다.

실패했을 때

실패한 하위에도 ▽ To Do로 이동이 나타납니다. 누르면 체인 전체가 To Do로 내려갑니다.

체인을 다루는 버튼

• ⤺ 체인 해제(독립 실행): 하위 카드에만 있습니다. 부모와의 연결을 끊고 그 체인 묶음 바로 뒤로 옮깁니다. 실행 중이거나 완료된 하위에는 없습니다.
• ⏸ 중지 (대기로 이동): 체인 중 하나를 멈추면 체인 전체가 To Do로 내려갑니다. 이미 완료된 명령은 완료 표시를 그대로 둡니다. To Do에서 다시 승격하면 멈춘 지점부터 이어집니다. 부모가 완료이고 남은 하위가 있으면 부모 카드에 승격 버튼이 보입니다.
• 🗑 삭제: 부모를 지우면 하위도 함께 지워집니다.
• ✎ 명령 편집: 하위도 실행 전이면 명령을 고칩니다.

하위 카드에는 승격·대화형 실행·경로 칩·☆·📎 버튼이 없습니다. 첨부는 체인 전체가 한 세션을 쓰므로 부모 카드의 📎에서 붙이고 봅니다. 즐겨찾기 ☆도 부모 카드에만 있습니다. 하위를 기다리는 부모에는 ⌘ 대화형 실행이 숨겨지고, 부모가 완료되거나 실패한 뒤에 다시 나타납니다.

예시 1: 빌드하고 로그 요약

빌드가 끝나면 하위가 같은 세션에서 빌드 출력을 보고 요약합니다. 빌드가 실패하면 요약은 돌지 않습니다. 부모를 대화형으로 열어 "오류 원인을 찾아 고쳐 줘"처럼 한 번 지시하면 부모가 완료로 바뀌고, 터미널을 종료하면 요약이 이어서 돕니다.

예시 2: 리팩터링, 테스트, 커밋 메시지

세 명령이 한 세션에서 순서대로 돕니다. 테스트 단계가 실패하면 커밋 메시지 단계는 멈춰 기다리고, 테스트 카드를 재실행해 통과하면 이어집니다. 이렇게 묶어 두고 자리를 비웠다가 돌아와 결과만 보면 됩니다.

사용 한도와 자동 재개

Claude Code에는 5시간 윈도우와 주간 한도가 있습니다. CmdQ는 한도에 걸린 작업을 실패로 끝내지 않고 리셋까지 세워 둡니다.

한도에 걸리면

• 돌고 있던 헤드리스 실행과 열려 있던 대화형 터미널을 모두 회수합니다. 한도는 계정 전체에 걸리므로 다른 경로 작업도 함께 멈춥니다.
• 회수한 항목은 리셋 대기가 되고, 자동 큐 위에 리셋까지 남은 시간과 함께 "대기 항목 위에서부터 자동 실행됩니다" 안내가 뜹니다.
• 회수한 터미널마다 "한도로 터미널 회수" 알림이 뜹니다. 큐 카드가 없는 터미널도 같습니다.
• 메뉴 막대 아이콘에 노란 점이 붙습니다.

리셋되면

• 리셋 시각이 지나면 리셋 대기 항목이 새 항목보다 먼저 실행됩니다.
• 이어받을 세션이 있으면 원래 명령을 다시 보내지 않고 같은 세션에 재개 지시를 보냅니다. 내용은 "아까 하던 작업을 이어서 진행해줘. 중간에 멈춘 지점부터 계속하고, 이미 끝낸 부분은 다시 하지 마."입니다. 이미 고친 파일을 처음부터 다시 고치지 않게 하려는 것입니다.
• 세션을 받기 전에 멈춘 항목은 원래 명령으로 다시 시작합니다.
• 리셋 대기 중에 명령을 편집하면 재개 지시 대신 고친 명령이 나갑니다.

카드 없이 연 터미널

대화형이나 ▶ 터미널, 즐겨찾기로 연 터미널은 큐 카드가 없습니다. 이런 터미널이 회수되면:

• 백그라운드 터미널 목록(⇧⌘T)에 리셋 대기 · HH:MM 재개 행이 생깁니다. 시각을 모르면 리셋 대기만 보입니다.
• 행을 누르면 그 세션의 지난 대화를 봅니다. 행의 ☆는 즐겨찾기 등록입니다.
• 리셋 뒤 그 세션을 백그라운드 터미널로 다시 열어 이어 갑니다. 끝나면 "한도로 회수한 터미널 N개를 이어서 재개했습니다" 토스트가 뜹니다.
• 다시 열 필요가 없으면 재개 취소를 누릅니다.

statusline 연결

첫 실행 때 Claude Code 사용량 연결을 한 번 묻습니다.

• 연결: ~/.claude/settings.json의 statusLine을 CmdQ 래퍼(cmdq-statusline.sh)로 바꿉니다. 사용량을 statusline 값에서 더 빨리 읽고, 원래 쓰던 statusline 표시는 그대로 나옵니다.
• 나중에: /usage 조회만 씁니다. 어느 쪽을 골라도 같은 Claude 설정 폴더에서는 다시 묻지 않습니다. 폴더가 바뀌면 다시 묻고, 설정 화면에는 이 메뉴가 없습니다.

카드 버튼

버튼 이름은 마우스를 올리면 뜨는 툴팁 글자입니다. 카드 상태에 따라 필요한 버튼만 나타납니다.

카드의 글자와 칩

• 명령 글자를 누르면 명령 전문 창이 열립니다. Esc나 바깥 클릭으로 닫힙니다.
• 세션 칩을 누르면 cd … && claude --resume … 명령이 복사됩니다. 앱 밖 터미널에 붙여 넣으면 같은 세션으로 들어갑니다. 경로 정보가 없는 세션이면 그 세션을 만든 폴더에서 실행해야 합니다.
• 경로 칩을 누르면 경로가 복사됩니다.
• #12 칩은 작업 번호입니다.

첨부

명령의 근거가 되는 파일·링크·메모를 붙여 둡니다. 첨부는 세션에 묶여서 같은 세션을 쓰는 명령들이 함께 봅니다.

붙이는 곳

• 추가바의 파일·링크·메모 버튼. 등록할 때 함께 들어갑니다.
• 카드의 📎로 여는 드로어. 하위 명령은 부모 카드의 📎를 씁니다.
• Finder에서 창으로 끌어다 놓기. 추가바에 놓으면 새 명령에, 열린 드로어에 놓으면 그 세션에 붙습니다.
• 즐겨찾기 행과 대화형 터미널 헤더의 📎. 카드를 지운 뒤에도, 첨부가 0개여도 보입니다.

링크는 http://나 https://로 시작해야 하고, 사용자 이름·비밀번호가 든 주소는 붙지 않습니다.

명령에 넣기

명령창에서 #을 치면 전체 첨부·세션 첨부·명령 첨부 목록이 뜹니다. Space로 여러 개를 체크하고 Tab을 누르면 마커가 들어갑니다. 체크한 게 있으면 Enter도 등록하지 않고 마커만 넣습니다.

보기

• 텍스트는 마크다운과 원문을 오가며 보고, 이미지와 PDF는 바로 미리 봅니다.
• 메모는 드로어에서 고칩니다. ⌘Enter 저장, Esc 취소입니다.
• 웹 링크는 앱 안 웹뷰에서 로그인한 상태 그대로 열립니다. 안 열리면 외부 브라우저로 열기를 씁니다.
• 로그인이 필요한 페이지는 본문 저장을 해 두십시오. claude에게 저장본이 넘어갑니다. 1MB를 넘는 본문은 앞부분만 저장됩니다.
• 목록의 행은 끌거나 위·아래 화살표로 순서를 바꿉니다.

한도

한도로 멈췄다가 재개하는 실행에는 첨부 목록을 다시 넣지 않습니다.

수명

첨부는 앱이 따로 만든 복사본이라 원본 파일은 건드리지 않습니다. 그 세션을 쓰는 명령·즐겨찾기·살아 있는 터미널이 모두 없어지면 복사본도 함께 지워집니다. 즐겨찾기를 지울 때 첨부가 같이 지워지게 되면 개수를 알려 주고 먼저 묻습니다.

대화형과의 관계

대화형 터미널은 마커를 펼치지 않습니다. 그래서 추가바에 첨부나 첨부 마커가 있으면 대화형이 열리지 않습니다. 터미널 안에서 첨부를 쓰려면 헤더의 📎에서 터미널에 넣기를 누릅니다(대화형 터미널).

대화형 터미널

큐에 맡기기 애매한 작업은 앱 안 터미널에서 claude와 직접 주고받습니다.

여는 방법

헤드리스로 돌고 있는 세션을 열 때

▶ 터미널, 즐겨찾기 ▶, 백그라운드 목록에서 연 세션을 자동 큐가 헤드리스로 실행 중이면 "실행을 멈추고 대화형 터미널로 넘길까요?" 확인창이 뜹니다.

• 확인하면 실행을 멈추고 터미널을 엽니다. 그 항목은 대화형으로 넘김 배지가 붙은 채 완료로 바뀌고 다시 실행되지 않습니다. 그 세션에서 돌던 백그라운드 작업도 함께 멈추며, 확인창이 그 개수를 알려 줍니다.
• 취소하면 아무것도 바뀌지 않습니다.
• 카드의 ⌘로는 넘기지 않습니다. 실행이 끝난 뒤 다시 열라는 안내가 뜹니다.

창 닫기와 백그라운드

• 백그라운드로 계속은 창만 닫고 작업은 계속 돌립니다. 다시 열면 같은 터미널에 접속합니다.
• 종료는 실행 중인 명령을 중단하고 세션을 끝냅니다.
• 헤더의 터미널 N개 버튼(⇧⌘T)이 살아 있는 터미널 목록을 엽니다. 행마다 프로젝트명·경로·세션·항목 번호가 보이고, ↑↓로 고르고 Enter로 엽니다.
• 살아 있는 터미널 행의 ✎ 이름 바꾸기로 목록에 보이는 이름을 정합니다. Enter로 저장하고 Esc로 취소합니다. 같은 이름이 리셋 대기 행과 터미널 창 헤더에도 보이지만, 바꾸는 곳은 목록 행의 ✎뿐입니다. 이름을 비우고 확정하면 원래 제목으로 돌아가고, 앱을 다시 켜도 이름이 남습니다. 이름은 보이는 제목만 바꿉니다. 큐 카드의 명령과 즐겨찾기 별칭, 경로 표시는 그대로입니다.
• 전체 종료는 한 번 더 눌러야 실행됩니다.
• 목록에서 연 터미널은 ⌃←로 목록에 돌아옵니다.

헤더

• 프로젝트명, 세션, 항목 번호, 명령이 보여 어느 작업인지 바로 압니다.
• 헤더의 프로젝트명을 누르면 프로젝트 경로가, 세션 표기를 누르면 세션 접속(claude --resume) 명령이 복사됩니다.
• ☆로 이 세션을 즐겨찾기에 넣거나 뺍니다.
• 🕐로 이 세션의 질문 목록을 터미널 위에 엽니다. 질문을 고르면 답이 펼쳐지고, 닫으면(×·Esc·바깥 클릭) 같은 터미널로 돌아와 바로 입력할 수 있습니다. 누를 때마다 새로 읽어 옵니다. 세션 id가 아직 없는 터미널에서는 눌리지 않다가 세션 id가 정해지면 켜집니다.
• 📎로 세션 첨부 창을 터미널 위에 엽니다. 드로어처럼 추가·삭제·순서 변경·메모 수정·끌어다 놓기가 되고, 터미널에 넣기·전체 넣기로 claude 입력줄에 붙여 넣습니다. Enter는 직접 누릅니다. 셸 모드(!)에서는 넣지 마십시오.
• 스니펫은 자주 쓰는 명령을 공통과 이 경로로 나눠 저장합니다. 고르면 편집 영역이 채워지고 적용을 누르면 터미널에 넣어 실행합니다. 고쳐서 적용해도 저장된 스니펫은 그대로입니다. 새 스니펫은 ⇧⌘P로 바로 추가합니다.

터미널 안에서

• 출력이 멎으면 입력 대기 알림이 뜹니다. 기준 시간은 설정의 대화형 입력 대기 알림(기본 8초)이고, 창을 보고 있을 때는 보내지 않습니다.
• 실패한 항목의 터미널에 처음 입력하면 그 항목이 완료로 바뀝니다. 체인 부모라면 하위가 이어집니다(체인).
• 화면의 주소는 Cmd+클릭으로 브라우저에서 엽니다.
• 이모지를 claude와 같이 2칸으로 세므로 이모지가 섞인 표나 패널이 어긋나지 않습니다. 창을 넓히면 열 수도 늘어납니다.
• claude에 mod 패널을 붙여 쓴다면, 패널을 마우스로 누르려면 claude를 fullscreen 렌더러로 띄워야 합니다. claude에서 /tui fullscreen을 실행하거나 CLAUDE_CODE_NO_FLICKER=1 환경변수를 주고 실행하십시오. 기본 렌더러의 claude는 마우스 입력을 받지 않습니다(claude 쪽 동작입니다).
• 더 넓게 쓰려면 설정 › 일반 › 터미널 창 폭을 전체 화면 폭으로 바꿉니다. 열려 있는 터미널에도 바로 적용됩니다.

화면이 비어 보일 때

다른 앱에 갔다 오거나 터미널을 다시 열면 claude가 화면 전체를 다시 그리게 합니다. 그래도 패널이나 글자가 비면 ⇧⌘D로 진단 파일을 저장해 이슈에 첨부해 주십시오. 앱 데이터 폴더의 diagnostics/에 저장되고, 터미널 출력이 담기므로 공유하기 전에 내용을 확인하십시오.

진행 상황과 기록

세션 이력에서

• 질문 행을 누르면 응답 상세가 열립니다. ⧉ 응답 복사로 응답을 복사합니다.
• 상세에서 ← 목록(⌃←)으로 돌아옵니다. 목록에서 ⌃←는 창을 닫습니다. ↑↓로 행을 오갑니다.
• 질문을 체크하고 🖼 이미지 생성이나 📄 PDF 생성을 누르면 고른 Q&A를 오래된 순으로 쌓아 저장합니다. 한꺼번에 고르려면 표시된 항목 모두 선택을 누릅니다.
• 스크롤해도 ← 목록과 선택·내보내기 바는 위에 붙어 있습니다.

로그 보존 기간은 설정의 끝난 작업 로그 압축·끝난 작업 로그 삭제를 따릅니다. 세션 이력 자체는 Claude Code 설정을 따릅니다(문제 해결).

즐겨찾기

다시 찾아갈 세션을 고정해 둡니다. 헤더의 ☆(⇧⌘B)로 패널을 엽니다. 패널은 경로별로 묶이고 위쪽 칸에서 검색합니다.

등록하는 곳

• 자동 큐 완료 카드의 ☆. 체인이면 부모 카드에만 있습니다.
• 대화형 터미널 헤더의 ☆
• 백그라운드 터미널 목록 행의 ☆. 리셋 대기 행에도 있습니다.

이미 등록된 세션은 ☆가 켜져 있고, 다시 누르면 빠집니다.

별칭과 경로

카드 없이 연 세션을 등록하면 별칭은 첫 질문의 첫 줄, 질문이 없으면 세션 ID 앞 8자입니다. 경로는 처음 연 폴더입니다. 별칭은 행의 ✎로 바꾸며 비워 둘 수 없습니다.

행 버튼

원래 카드를 지워도 즐겨찾기는 남고, 그 세션의 첨부도 남아 📎로 계속 엽니다. 즐겨찾기를 지울 때 함께 지워질 첨부가 있으면 "이 북마크를 지우면 첨부 N개도 함께 삭제됩니다" 확인이 먼저 뜹니다.

설정

⌘,나 헤더의 ⚙, 메뉴 막대의 설정…으로 엽니다. 값을 바꾸고 저장을 눌러야 반영됩니다. ↻ 재시작이 붙은 항목은 앱을 다시 켜야 적용됩니다. 범위 밖 값은 가까운 경계로 보정됩니다.

단축키

바꾸는 법

설정의 단축키 묶음에서 키 칸을 누르고 원하는 조합을 누릅니다. 해제는 없음으로 만들고, 기본값은 처음 조합으로 되돌립니다. 조합에는 ⌘·⌥·⌃ 중 하나가 들어가야 하고, 다른 동작이 쓰는 조합은 지정되지 않습니다.

제약

• 앱 창에 포커스가 있을 때만 동작합니다.
• 전면 모달이나 대화형 터미널이 열려 있으면 설정·스니펫 추가·뒤로만 동작합니다. 터미널 키는 백그라운드 터미널 목록이 열려 있을 때 목록을 닫는 용도로만 동작합니다.
• 명령창 제출 키(Enter=To Do, ⌘Enter·⌃Enter·⌃⌘Enter=자동 큐, Shift+Enter=줄바꿈)는 바꿀 수 없습니다.
• 앱 메뉴가 먼저 쓰는 ⌘C·⌘V·⌘X·⌘A·⌘Z·⇧⌘Z·⌘Q·⌘H·⌥⌘H·⌘M·⌃⌘F와 터미널 진단 저장 ⇧⌘D는 지정할 수 없습니다.
• 대화형 터미널에서 뒤로 키가 할 일이 없으면 ⌃←는 터미널로 그대로 넘어갑니다.
• macOS Mission Control의 「왼쪽 스페이스로 이동」(⌃←)이 켜져 있으면 뒤로 키를 다른 조합으로 바꾸십시오.

config.toml

설정은 ~/Library/Application Support/com.doitasap.cmdq/config.toml에 저장됩니다. 설정 화면에 없는 항목은 이 파일에서만 바꿉니다.

고칠 때 주의

• 앱을 끈 뒤 고치십시오. 앱은 시작할 때만 이 파일을 읽고, 설정 화면에서 저장하면 파일 전체를 다시 씁니다. 실행 중에 고친 내용은 덮어써집니다.
• 범위를 벗어난 값은 가까운 경계로 보정하고, 상대경로는 지웁니다. 보정하면 알려 줍니다.
• 파일을 해석하지 못하면 원본을 .bak으로 백업하고 기본값으로 실행합니다.

문제 해결

여기에 없는 문제는 메뉴 막대의 버그 제보로 알려 주십시오.