TaskHolder 지원
Mac과 Windows용 TaskHolder Desktop 도움말입니다.
72시간 이내에 답변드립니다. 사용 중인 컴퓨터(Mac 또는 Windows), 시스템 버전, TaskHolder 버전(Mac은 TaskHolder ▸ 정보, Windows는 도움말 ▸ 정보), 로그인한 이메일 주소를 함께 적어 주세요.
시작하기
- taskholder.app/download에서 내려받으세요. Mac 버전은 Apple Silicon과 Intel 모두에서, Windows 버전은 Windows 10 이상에서 동작해요.
- 처음 열면 Google로 로그인해요. 브라우저가 열리고 계정을 고르면 TaskHolder가 알아서 이어져요. 로그인한 계정에 체험과 라이선스가 담겨요.
- 짧은 환영 화면과 안내 투어가 기본을 보여줘요. 투어는 도움말 ▸ 튜토리얼에서 언제든 다시 볼 수 있어요.
계획 가져오기
.md파일을 캔버스에 끌어다 놓거나, 파일 ▸ Markdown 가져오기(⌘ I / Ctrl I), 또는 사이드바의 Markdown 가져오기 버튼을 쓰세요.- TaskHolder가 파일을 읽는 방식(키워드, 번호, 체크리스트, 제목)을 골라 하단에 표시해요. 배지를 누르면 같은 파일을 다른 방식으로 다시 읽을 수 있고, 법률·학술 번호용 식별자 모드도 있어요.
- 카드가 이미 있는 프로젝트에 가져오면 새 프로젝트로 열기와 현재 프로젝트에 병합을 고를 수 있어요. 병합은 ⌘ Z / Ctrl Z 한 번으로 되돌려요.
- 프로젝트를 만들 때 Code, Video, Blog 모드를 고를 수 있고, 카드 이름과 메뉴가 모드를 따라가요.
- 원본 파일이 디스크에서 바뀌면 지금 버전을 지킬지 새 버전을 불러올지 물어봐요.
캔버스와 사이드바
- 카드의 상태를 누르면 Not Yet → In Progress → Testing → Done 순으로 바뀌어요.
- 도구: 선택 V, 손 H(또는 Space 누르고 있기), 연결 C, 내보내기 E. 모든 단축키는 설정 ▸ 단축키에서 바꿀 수 있어요.
- 파일, 링크, 프롬프트를 카드에 클립으로 붙이고, 클립을 더블클릭하면 열려요.
- 작업 구조 사이드바는 번호가 매겨진 트리를 보여줘요. 검색하고, 끌어서 순서를 바꾸거나 다른 작업 아래로 옮기고, 고정하고, 여러 작업을 골라 그것만 내보낼 수 있어요.
- 실행 취소와 다시 실행은 50단계까지 돼요.
카드를 Claude Code로 보내기
E로 내보내기 모드를 켜고, 카드를 골라 Claude Code 터미널, 다른 명령줄 도구, 채팅 창으로 끌어다 놓으세요. Markdown으로 들어가요. 한 번에 10장까지를 권장해요(최대 50장).
내보내기
- 파일 ▸ 내보내기로 Markdown, JSON, YAML, 일반 텍스트를 프로젝트 전체나 선택한 카드만 저장해요.
- 설정에서 원본 문서 보존을 켜면, 가져온 계획을 전체 내보낼 때 고친 카드의 줄만 바뀌고 나머지는 원래 그대로 남아요.
- 프로젝트는 모든 내용을 담은
.taskflow파일로 저장돼요. 더블클릭하면 열려요.
에이전트 컨트롤 타워
- Claude Code(같은 컴퓨터에 설치된 2.1.269 이상)를 위한 선택 기능이에요: 세션 목록, 실시간 활동 피드, 입력 필요 알림, 턴이 끝날 때 울리는 소리(선택), 보낸 카드의 배지와 진행 상황.
- 설정 ▸ 에이전트에서 켜고 Claude Code에 연결을 누르세요. 바꾸기 전에 어떤 Claude Code 설정 파일에 무엇을 추가하는지 정확히 보여주고, 먼저 백업해요. 연결 해제하면 파일이 원래대로 돌아가요.
- 내 컴퓨터에서 Claude Code가 알려주는 정보만 읽어요. API 키, 계정, 추가 비용이 없고, 인터넷으로 보내는 것도 없어요.
- 카드 상태 자동 반영(선택)은 카드를 In Progress와 Testing으로 옮겨요. Done은 항상 직접 정해요.
- Mac에서는 카드를 오른쪽 클릭해 Claude Code에서 실행(터미널 또는 백그라운드)할 수 있어요.
- Codex, Gemini CLI 등 다른 에이전트는 지원하지 않아요.
체험, 구매, 라이선스
- 체험은 처음 로그인한 날부터 14일이며, 결제 정보 없이 모든 기능을 써요. 계정에 연결되므로 다시 설치해도 새로 시작되지 않아요.
- 끝나기 3일 전에 백업하라고 알려줘요.
- 체험이 끝나면 계속 편집하기 전에 구매를 안내해요. Markdown으로 전체 내보내기는 계속 쓸 수 있고,
.taskflow파일도 디스크에 그대로 있어요. - 앱과 같은 계정으로 로그인해 taskholder.app에서 구매하세요. 구독이 아닌 한 번 구매예요. 결제는 판매 대행사(merchant of record)인 Polar가 처리하며, 영수증 발송과 세금 처리도 Polar가 해요.
- 라이선스는 계정을 따라가요. 새 컴퓨터나 다시 설치한 뒤에도 로그인만 하면 돼요. 라이선스 키는 없어요.
- 네트워크나 서버 문제로 유료 라이선스가 잠기는 일은 없어요.
- 환불: 구매 후 14일 이내에 메일로 알려주세요. 환불되면 계정에서 라이선스가 해제돼요.
업데이트
TaskHolder는 시작할 때 새 버전을 확인하고 머리글의 종 아이콘에 알려줘요. 내려받고 설치하는 시점은 직접 정해요.
내 데이터
- 계획, 카드, 첨부 파일 경로는 내 컴퓨터의 앱 저장 공간과 직접 저장한
.taskflow파일에만 있어요. 저희에게 업로드되지 않아요. - 백업하세요:
.taskflow파일을 백업 도구(Time Machine, 파일 히스토리, 클라우드 폴더)가 챙기는 곳에 저장하거나 Markdown으로 내보내 두세요. - 앱을 삭제해도 저장된 데이터는 지워지지 않아요. 위치는
~/Library/Application Support/TaskHolder Desktop(Mac),%APPDATA%\TaskHolder Desktop(Windows)이에요. - 계정 삭제는 taskholder.app/account에서 해요. 로그인, 체험, 라이선스가 지워지며, 구매한 라이선스는 이후 되살릴 수 없어요. 내 컴퓨터의 파일에는 영향이 없어요.
- 자세한 내용: 개인정보 처리방침.
문제 해결
Mac: "TaskHolder Desktop을(를) 열 수 없습니다"
시스템 설정 ▸ 개인정보 보호 및 보안을 열고 아래로 내려 TaskHolder Desktop 옆의 그래도 열기를 누른 뒤 앱을 다시 여세요.
Windows: "Windows의 PC 보호"
추가 정보를 누르고 실행을 누르세요. 설치 파일은 taskholder.app에서만 내려받으세요.
로그인하려고 브라우저가 열렸는데 앱이 이어지지 않아요
브라우저에서 Google
계정 선택을 마친 뒤 TaskHolder로 돌아오세요. 계속 기다리면 브라우저 탭을 닫고 다시 시도하세요. 내 컴퓨터의
127.0.0.1 연결을 막는 방화벽이나 보안 프로그램이 있으면 브라우저가 로그인을 앱에 넘겨주지
못할 수 있어요.
구매했는데 아직 체험으로 보여요
앱에서 쓰는 계정과 같은 계정으로 구매했는지 확인하세요. TaskHolder를 앞으로 가져오거나 설정 ▸ 계정에서 새로고침하세요. 몇 분이 지나도 그대로면 로그인 이메일과 Polar 영수증을 메일로 보내 주세요.
컴퓨터 시계가 맞지 않다는 메시지가 나와요
시스템 설정에서 날짜와 시간 자동 설정을 켜고, 인터넷에 연결된 상태에서 TaskHolder를 다시 시작하세요. 데이터에는 영향이 없어요.
가져온 계획이 이상하게 보여요
하단의 모드 배지를 눌러 다른 모드로 읽거나 카드 깊이를 바꿔 보세요. 그래도 이상하면 파일(또는 같은 구조의 샘플)을 메일로 보내 주세요.
에이전트 컨트롤 타워에 세션이 안 보여요
Claude Code 2.1.269 이상이
설치돼 있는지(claude --version), 패널 필터가 모든 폴더인지, Claude Code를 실행한 폴더를
Claude Code에서 신뢰했는지 확인하고 패널의 다시 확인을 누르세요. 조직 정책으로 Claude Code 훅이 꺼져
있으면 세션 목록만 동작해요.
다시 설치했더니 프로젝트가 없어요
.taskflow 파일로 저장한
프로젝트는 저장한 곳에 그대로 있으니 파일 ▸ 열기로 여세요. 앱 저장 공간의 데이터는 지우지 않았다면
내 데이터에 적힌 폴더에 남아 있어요.
더 도움이 필요하신가요?
magenta23.lab@gmail.com로 메일을 보내 주세요. 72시간 이내에 답변드립니다.