Skip to content
NotesNotes
Esc
↑↓navigate↵open⌘Jpreview
On this page

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.

Last updated on