Handoffs
Handoff notes are tagged notes with workflow metadata.
Handoffs are normal notes with a handoff tag. They are used by agent workflows to pass context between sessions.
---
repo: owner/repo
date: 2026-07-06T12:00:00+01:00
type: handoff
name: Checkout Flow Handoff
description: Current state and next steps for checkout work.
priority: medium
tags: [handoff]
---
Priority
Note priority can be low, medium, high, or critical. Missing priority is treated as medium.
notes handoffs
notes handoffs --all
notes handoffs --list
notes handoffs --format json
notes handoffs opens the same two-pane TUI as notes, filtered to notes tagged handoff. Use --list when you want stdout output for scripts or non-interactive shells. notes handoff is an alias for notes handoffs.
The handoff view uses the same priority-aware controls as the main notes TUI:
| Key | Action |
|---|---|
g |
Toggle grouping by priority |
p |
Change the selected note’s priority |
s |
Cycle sorting within the current grouping |
Instructions
The standalone notes tool only owns storage and listing semantics. Handoff authoring instructions live in the consuming agent configuration, such as the dotfiles handoff skill.