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 0 (optional): Remote Project Routing Some users keep projects on remote machines and SSH into them. If you want `/pickup <project>` to transparently route to a remote host, drop a config file at `~/.claude/pickup-routes.json`: ```json { "routes": [ { "prefix": "work", "host": "myserver", "ssh_alias": "ssh myserver", "project_root": "~/projects", "remote_home": "/home/me" } ] } ``` When the first word of the argument matches a `prefix`, the skill runs all subsequent searches (`find`, `git`, `cat`) via that SSH alias. Paths are reported with the host prefix (e.g. `myserver:~/projects/foo/`) so it's clear the project is remote. If the file doesn't exist, skip this step entirely. Local search (Step 1) is the default flow. --- ## Step 1: Locate HANDOFF.md > If Step 0 matched a configured remote prefix, run these searches on the remote machine via SSH instead of locally. **If the argument is a file path** (starts with `/`, `./`, or `~/`): - Use that exact path (locally or via SSH if the path is on a remote machine). **If the argument is a project name** (e.g., `MyProject`, `my-app`): - Search `~/projects/` recursively (2 levels deep) for a directory matching the name (case-insensitive). ```bash find ~/