Handoffs

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.