Support

What TaskHolder does

TaskHolder turns a Markdown plan into cards you can see and move. Import a plan your AI wrote, or one you wrote yourself. Its phases and tasks become cards on a canvas, and the full outline appears in the task tree.

Reorder the plan, edit cards, track their status, and attach files, links and prompts. Drag cards into Claude Code or any other app as Markdown, and export the plan back to Markdown when you're done. Importing never changes your original .md file.

The optional AI Control Tower shows which Claude Code session is working on which card. It runs on your Mac and needs no API key.

Install

Download the .dmg from the download page, open it, and drag TaskHolder to Applications. macOS 12 or later, Apple Silicon and Intel both supported.

If macOS says the app "is damaged": that message means the download lost its signature — usually an interrupted download. Delete it, empty the Trash, and download again. If it repeats, contact me rather than working around it.

Your first 14 days

Sign in once, and the full app is yours for 14 days — every feature, no card required. The trial is tied to your account, not to the machine, so reinstalling doesn't restart it and doesn't cut it short.

When it ends, TaskHolder asks you to buy a license before you keep editing. Exporting your work always stays open, even after the trial ends. Your files are yours.

Your first project

1. Create a project. Press ⌘N and choose Code, Video or Blog to match what you're planning.

2. Import your plan. Press ⌘I or drop a .md file on the canvas. The footer shows how the file was read, under 🧭 Parsed as.

3. Shape it. Reorder tasks in the task tree on the left. Double-click a card to edit it.

4. Hand cards over. Press E for Export mode, select cards, and drag them into Claude Code, a chat window or any app. They arrive as Markdown.

5. Save and export. ⌘S saves the project as a .taskflow file. File ▸ Export writes Markdown, JSON, YAML or plain text.

Help ▸ Tutorial walks you through these steps inside the app. You can replay it any time.

After you buy

One payment, yours forever — no subscription. The license lives on your account, so signing in on a new computer restores it. There is no license key to lose and no "restore purchase" button to hunt for: signing in is the restore.

Bring a plan in

Drop a Markdown file onto the canvas, or press ⌘I. Headings become cards, and their levels become the hierarchy you see. Bullets under a heading stay in that card as text. How TaskHolder reads your document

TaskHolder keeps the original text with the project. With Preserve source document on (Settings ▸ Editor, off by default), a full export of an imported file keeps everything you didn't edit exactly as it was, including formatting, spacing and comments.

Shape it

Reorder or re-parent tasks by dragging them in the task tree. Move cards freely on the canvas, and double-click empty canvas to add one. The canvas shows the lowest-level cards; phases and other parent cards live in the tree.

⌘N

New project

⌘O

Open project

⌘S

Save

⌘I

Import Markdown

⌘E

Export

⌘Z

Undo

Most canvas shortcuts can be changed in Settings → Shortcuts.

Send it back to work

Press ⌘E to export in your default format, or choose Markdown, JSON, YAML or plain text under File ▸ Export. To hand individual cards to an AI, press E, select the cards, and drag them into Claude Code or a chat window.

Markdown vs .taskflow: Markdown is for reading and for handing off. .taskflow is the full project file — it keeps card positions, clips and everything else. Use it to save your work; use Markdown to share it.

Follow Claude Code (optional)

Turn on AI mode in Settings ▸ AI & Agents, then choose Connect to Claude Code. Before anything is written, the dialog shows which settings file will change and what will be added. Disconnect removes only what it added.

Drag cards into a Claude Code session, or use Start in Claude Code in the AI panel to start a session with your whole plan. Each card shows the session working on it. With automatic status on, cards move to Test as Claude finishes them. Marking a card Done is always up to you.

Needs Claude Code 2.1.269 or later on the same Mac. No API key and no extra cost.

How TaskHolder reads your document

TaskHolder reads each file in one mode. It checks the five modes below in order and uses the first one that fits the whole document.

Keyword

## Phase 1 · ### Task 1.1

Numbered

## 1. · ### 1.1

Identifier

AW-03 · FR-1 · Article 1 · 제1조

Checklist

- [ ] lines

Heading

The number of # sets the level

Keyword mode knows Phase, Step, Stage, Part, Chapter, Task, Item, Action, Todo and Subtask. Each needs a number after it, like "Phase 1" or "Task 2.3".

The footer shows the mode under 🧭 Parsed as. If the cards split the wrong way, choose another mode there. TaskHolder reloads the original file in that mode and discards edits made since the import, so switch right after importing.

Nothing is thrown away. A title or intro before the first task is kept with the project, and so are sections after the last task. Plain bullets and bold labels stay inside their card as text. The canvas shows the lowest-level cards; phases and other parent cards are in the task tree.

Writing plans that import well

Give each task its own heading. For example ## Phase 1: Setup, then ### Task 1.1: Install. Each heading becomes a card.

Number your keywords. "Phase 1" and "Task 2.3" are read as structure. The word "Phase" on its own is not.

Use one style per file. The whole file is read in one mode, so mixing numbered and keyword headings can give you cards you didn't expect.

Put details under the heading. Bullets and paragraphs below a heading become that card's text. To turn list items into cards, change Card Depth Level in Settings ▸ Editor.

Keep IDs in your headings. Headings such as ### AW-01 or ### P0-1 under a phase become child cards.

Writing in Korean or Chinese? The keywords are English words. Use numbered headings such as ## 1. and ### 1.1, or document numbering such as 제1조.

Ask your AI for this format. For example: "Write the plan with ## Phase N: title and ### Task N.M: title headings. Put the details for each task as bullets under its heading."