Macros

Macros

Record and replay sequences of actions.

---

Overview

Macros let you record a sequence of keystrokes and replay them later. Useful for repetitive tasks.

---

Recording a Macro

1. Press Ctrl+r to start recording
2. Perform your actions
3. Press Ctrl+r again to stop

The status bar shows [REC] while recording.

---

Playing a Macro

Press Ctrl+m to replay the last recorded macro.

---

Recording Display

While recording:

┌────────────────────────────────────────────────────────────┐
│ TaskFlow                                    [REC] 12 keys  │
├────────────────────────────────────────────────────────────┤
│ ...                                                        │
└────────────────────────────────────────────────────────────┘

---

Example: Batch Priority Update

Record a macro to set high priority and move to next task:

1. Ctrl+r (start recording)
2. p (cycle to high priority)
3. j (move down)
4. Ctrl+r (stop recording)

Now Ctrl+m repeats this for each task.

---

Example: Add Tag to Multiple Tasks

1. Ctrl+r (start)
2. T (edit tags)
3. Type important
4. Enter (confirm)
5. j (next task)
6. Ctrl+r (stop)

Press Ctrl+m to tag each subsequent task.

---

Example: Create Task Template

1. Ctrl+r (start)
2. n (new task)
3. Type Weekly review #work !high due:friday
4. Enter (create)
5. Ctrl+r (stop)

Replay to quickly create the same task pattern.

---

Macro Limitations

What Gets Recorded

• Key presses
• Navigation commands
• Task operations

What Doesn't Get Recorded

• Mouse actions
• Time delays
• External events

---

Macro Storage

Macros are stored in memory only. They're lost when you quit TaskFlow.

Persistence Workaround

For persistent macros, create shell aliases:

# In ~/.bashrc or ~/.zshrc
alias tf-weekly='echo "Weekly review #work" | taskflow --quick-add'

---

Tips

1. Plan before recording - Know your keystrokes
2. Keep macros short - Easier to debug
3. Test immediately - Verify it works
4. Use for repetition - Best for 5+ similar actions

---

Common Macros

Set Due Today + High Priority

p p p (to high) → D → today → Enter

Move to Project

m → (select project) → Enter → j

Complete and Archive

x → j

Add Standard Tags

T → work,urgent → Enter → j

---

Keybindings

Key	Action
Ctrl+r	Start/Stop recording
Ctrl+m	Play macro

---

Troubleshooting

Macro Does Wrong Thing

• Re-record with correct starting position
• Check you're in the right mode/view
• Verify selection state

Macro Lost

• Macros only persist during session
• Re-record after restart

Recording Won't Start

• Ensure not in edit mode
• Press Escape first to clear state

---

See Also

• Keybindings - All keyboard shortcuts
• Task-Management - Task operations
• Quick-Start - Basic usage