Skip to content
Notes logoNotes

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

Section titled “Priority”

Handoff priority can be low, medium, high, or critical. Missing priority is treated as medium.

Terminal window
notes handoffs
notes handoffs --all
notes handoffs --format json

notes handoff is an alias for notes handoffs.

Instructions

Section titled “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.