pickuplisted

# /pickup -- Session Pickup > Consume a HANDOFF.md and orient the session so work continues exactly where it left off. When invoked, perform the following steps in order. Do not ask for confirmation -- just execute. --- ## Step 1: Locate HANDOFF.md **If the argument is a file path** (starts with `/`, `./`, or `~/`): - Use that exact path. **If the argument is a project name** (e.g., `my-project`, `cool-app`): - Search `~/projects/` recursively (2 levels deep) for a directory matching the name (case-insensitive). ```bash find ~/projects -maxdepth 3 -type d -iname "*<argument>*" 2>/dev/null ``` - For each match, check if `HANDOFF.md` exists in that directory. - Also check `~/HANDOFF.md` -- read its first 5 lines and check if the Project path contains the argument. - If exactly one HANDOFF.md found -- use it. - If multiple found -- list them with dates, ask user which one. - If none found in project dirs but `~/HANDOFF.md` matches -- use that. **If no argument**: 1. Check current working directory for `HANDOFF.md` 2. Check `~/HANDOFF.md` 3. Search `~/projects/` subdirectories (2 levels deep) for recent `HANDOFF.md` files 4. If multiple found -- list them with dates, ask user which one If no HANDOFF.md is found anywhere: - Report clearly: "No HANDOFF.md found. Either provide a path or project name: `/pickup my-project`" - Stop. --- ## Step 2: Read and Parse Read the HANDOFF.md fully. Extract: - **Project path** from the Project section - **Branch** and **last co